IDirectMusicPerformance::GetGlobalParam

The IDirectMusicPerformance::GetGlobalParam method retrieves global values from the performance.

HRESULT GetGlobalParam(
  REFGUID rguidType, 
  void* pParam,
  DWORD dwSize
);
 

Parameters

rguidType

Reference to (C++) or address of (C) the identifier of the type of data.

pParam

Allocated memory to receive a copy of the data. This must be the correct size, which is constant for each type of data, and was also passed into the IDirectMusicPerformance::SetGlobalParam method.

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 may return one of the following error values:

Remarks

If rguidType isn't in the list of global data being handled by this performance, the method returns E_INVALIDARG. Make sure to call SetGlobalParam first.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

IDirectMusicPerformance::SetGlobalParam, IDirectMusicPerformance::GetParam, Music Parameters