Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::PChannelInfo

指定されたパフォーマンス チャンネルのポート、グループ、および MIDI チャンネルを取得する。

HRESULT PChannelInfo(
  DWORD dwPChannel, 
  IDirectMusicPort** ppPort,
  DWORD* pdwGroup,
  DWORD* pdwMChannel
);

パラメータ

dwPChannel
情報が必要とされるパフォーマンス チャンネル。
ppPort
IDirectMusicPort8 ポインタを受け取る変数のアドレス。ポインタが不要な場合は、NULL でもよい。NULL 以外のポインタが返される場合、参照カウントはインクリメントされる。ポインタに対して Release を呼び出すのはアプリケーションである。「注意」も参照すること。
pdwGroup
ポート上のグループへのポインタを受け取る変数のアドレス。この値が不要な場合は、NULL でもよい。
pdwMChannel
グループ内の MIDI チャンネルへのポインタを受け取る変数のアドレス。この値が不要な場合は、NULL でもよい。

戻り値

成功した場合は S_OK を返す。

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

E_INVALIDARG
E_POINTER

注意

IDirectMusicPerformance8::RemovePort の呼び出しによってポートが削除された場合、*ppPort には NULL ポインタが返されるが、メソッドは成功する。

動作環境

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

参照

IDirectMusicPerformance8::AssignPChannelIDirectMusicPerformance8::AssignPChannelBlock