Microsoft DirectX 8.0 (C++)

IDirectMusic8::EnumPort

システムに接続されている DirectMusic ポートの能力を列挙および取得する。このメソッドを呼び出すたびに、1 つのポートに関する情報を取得する。

HRESULT EnumPort(
  DWORD dwIndex, 
  LPDMUS_PORTCAPS pPortCaps 
);

パラメータ

dwIndex
能力を取り出したいポートのインデックス番号。最初に呼び出すときはこのパラメータを 0 に設定し、それ以降は呼び出しのたびに 1 ずつ大きくすべきである。S_FALSE が返されるまで呼び出しを続ける。
pPortCaps
ポートの能力を受け取る DMUS_PORTCAPS 構造体のアドレス。ポインタを渡す前に、この構造体の dwSize メンバを初期化しなければならない。

戻り値

成功した場合は S_OK を返す。指定したインデックス値を持つポートが存在しない場合は S_FALSE を返す。

失敗した場合は、次のいずれかのエラー値を返す。

E_INVALIDARG
E_NOINTERFACE
E_POINTER

注意

アプリケーションはポートのインデックス番号を信頼したり保存すべきではない。再起動またはハードウェアの追加や削除が行われると、ポートのインデックス番号が変化する可能性がある。

動作環境

  ヘッダー : dmusicc.h で宣言。