Platform SDK: DirectX

IDirectMusicTool::GetMediaTypes

IDirectMusicTool::GetMediaTypes メソッドは、このツールがサポートするメッセージ タイプのリストを取り出す。

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

パラメータ

padwMediaTypes
DWORD の配列のアドレス。このメソッドは、ツールがサポートしているメディア タイプをこの配列に書き込む。メディア タイプについては、DMUS_PMSGT_TYPES を参照すること。
dwNumElements
padwMediaTypes 配列内の要素の数。この値は、IDirectMusicTool::GetMediaTypeArraySize メソッドが返した数と一致しているべきである。dwNumElements の値がこの数より小さい場合、メソッドはサポートされているすべてのメッセージ タイプを返せない。値がこの数より大きい場合、配列内の余分の要素は 0 に設定される。

戻り値

戻り値は実装によって決まる。成功すれば S_OK を返す。dwNumElements が小さすぎてすべての値を書き込めなかった場合は S_FALSE を返す。失敗すれば次のエラー値のいずれかを返す。

E_POINTER
E_INVALIDARG
E_NOTIMPL

注意

メソッドが E_NOTIMPL を返す場合、ツールはすべてのメディア タイプを処理する。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。