Platform SDK: DirectX

IDirectMusicPortDownload::GetDLId

IDirectMusicPortDownload::GetDLId メソッドは、1 つまたは複数のダウンロード バッファのシーケンシャル識別子を取得する。

シンセサイザにダウンロードされたすべてのメモリ チャンクは、自らの DMUS_DOWNLOADINFO 構造体内で一意の識別子を保持していなければならない。GetDLId メソッドは、2 つのダウンロードが同じ識別子を持っていないことを保証する。

HRESULT GetDLId(
  DWORD* pdwStartDLId, 
  DWORD dwCount
);

パラメータ

pdwStartDLId
最初の識別子を受け取る変数のアドレス。
dwCount
予約される識別子の数。一連のチャンク全体を一度にダウンロードするよう計画もできる。チャンクごとに GetDLId を呼び出す代わりに、dwCount をチャンク数に設定する。GetDLId はセットの最初の ID を返し、*pdwStartDLIddwCount までの範囲で他の識別子が自動的に予約される。それ以降 GetDLId を呼び出すと、それまでの予約値は飛ばされる。

戻り値

成功すれば S_OK を返す。

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

E_POINTER
E_INVALIDARG

動作環境

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

参照

IDirectMusicPortDownload::GetBuffer下位レベル DLS