| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicPerformance8::SetGlobalParam
The SetGlobalParam method sets global values for the performance.
Syntax
HRESULT SetGlobalParam(
REFGUID rguidType,
void* pParam,
DWORD dwSize
);
Parameters
rguidType
Reference to (C++) or address of (C) the identifier of the type of data.
pParam
Address of data to be copied and stored by the performance.
dwSize
Size of the data. This is constant for each rguidType.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| E_FAIL |
| E_POINTER |
| E_OUTOFMEMORY |
Remarks
The dwSize parameter is needed because the performance does not know about all types of data. New types can be created as needed.
For the parameters defined by DirectMusic and their associated data types, see Setting and Retrieving Global Parameters.
Requirements
Header: Declared in dmusici.h.
See Also
- IDirectMusicPerformance8 Interface
- IDirectMusicPerformance8::GetGlobalParam
- IDirectMusicPerformance8::SetParam
- Performance Parameters
© 2004 Microsoft Corporation. All rights reserved.