Platform SDK: DirectX

IDirectMusicPerformance::PChannelInfo

IDirectMusicPerformance::PChannelInfo メソッドは、指定されたパフォーマンス チャンネルのポート、グループ、および MIDI チャンネルを取り出す。

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

パラメータ

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

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

E_INVALIDARG
E_POINTER

注意

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

動作環境

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

参照

IDirectMusicPerformance::AssignPChannelIDirectMusicPerformance::AssignPChannelBlock