Microsoft DirectX 9.0 SDK Update (October 2004)

IDirectMusicTool8::GetMediaTypes

The GetMediaTypes method retrieves a list of the types of messages that this tool supports.

Syntax

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

Parameters

padwMediaTypes

Address of 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 padwMediaTypes array. This value is equal to the number returned by the IDirectMusicTool8::GetMediaTypeArraySize method. If dwNumElements is less than this number, the method cannot return all 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 the method succeeds, it returns S_OK, or S_FALSE if the method could not fill in all values because dwNumElements was too small. If it fails, the method can return one of the error values shown in the following table.

Return code
E_POINTER
E_INVALIDARG
E_NOTIMPL

Remarks

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

Requirements

  Header: Declared in dmplugin.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.