Platform SDK: DirectX

IDirectMusicSegment::SetPChannelsUsed

IDirectMusicSegment::SetPChannelsUsed メソッドは、このセグメントが使うパフォーマンス チャンネル (P チャンネル) を設定する。このメソッドは通常、トラックがどの P チャンネルを使っているかをセグメントに通知するために IDirectMusicTrack::Init メソッド内でトラックによって呼び出される。

HRESULT SetPChannelsUsed(
  DWORD dwNumPChannels,
  DWORD* paPChannels
);

パラメータ

dwNumPChannels
設定される P チャンネルの数。この値は、paPChannels が指す配列内のメンバの数と等しくなければならない。
paPChannels
P チャンネルの配列へのポインタ。

戻り値

成功すれば S_OK を返す。

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

E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

注意

このメソッドを使うと、セグメントがどのポートを使っているかをパフォーマンスに知らせ、その結果、パフォーマンスがワースト ケースに備える代わりに実際の遅延時間を決定できる。

動作環境

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

参照

遅延時間とバンパー時間チャンネル