Microsoft DirectX 8.0 (C++)

IDirectMusicPortDownload8::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

動作環境

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

参照

IDirectMusicPortDownload8::GetBuffer下位レベル DLS