Platform SDK: DirectX |
IDirectMusic::EnumPort メソッドは、システムに接続されている DirectMusic ポートの能力の列挙と取得に使われる。このメソッドを呼び出すたびに、1 つのポートに関する情報を取り出す。
HRESULT EnumPort( DWORD dwIndex, LPDMUS_PORTCAPS pPortCaps );
成功すれば S_OK を返す。指定したインデックス値を持つポートが存在しない場合は S_FALSE を返す。
失敗すれば次のエラー値のいずれかを返す。
E_INVALIDARG |
E_NOINTERFACE |
E_POINTER |
アプリケーションはポートのインデックス番号を信頼したり保存すべきではない。再起動またはハードウェアの追加や削除が行われると、ポートのインデックス番号が変化する可能性がある。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusicc.h で宣言。