IDirectMusicTool::GetMediaTypes

The IDirectMusicTool::GetMediaTypes method retrieves a list of the type of messages this tool supports.

HRESULT GetMediaTypes(
  DWORD** padwMediaTypes,
  DWORD dwNumElements
);
 

Parameters

padwMediaTypes

Address of a pointer to an array of DWORDs. The method fills this array with the media types supported by this tool. For media types, see DMUS_PMSGT_TYPES.

dwNumElements

Number of elements in the array padwMediaTypes. This value should be equal to the number returned by the IDirectMusicTool::GetMediaTypeArraySize method. If dwNumElements is less than this number, the method can't return all of the message types that are supported. If it is greater than this number, the extra elements in the array should be set to 0.

Return Values

Return values are determined by the implementation. If successful, the method should return S_OK, or S_FALSE if the method couldn't fill in all values because dwNumElements was too small. If it fails, the method may return one of the following error values:

Remarks

If the method returns E_NOTIMPL, the tool processes all media types.

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.