次の方法で共有


SYNTHDOWNLOAD 構造体 (dmusprop.h)

SYNTHDOWNLOAD 構造体は、ダウンロードされた DLS データのハンドルを指定します。 また、DLS データを含むバッファーを解放できるかどうかを指定します。

構文

typedef struct _SYNTHDOWNLOAD {
  HANDLE DownloadHandle;
  BOOL   Free;
} SYNTHDOWNLOAD, *PSYNTHDOWNLOAD;

メンバーズ

DownloadHandle

ダウンロードした DLS データ バッファーへのハンドル。ミニポート ドライバーは、後でアンロードできるように DLS データを一意に識別するために生成します。

Free

DLS のダウンロードが完了するとすぐに、クライアントがデータ バッファーを解放できるかどうかを指定します。 TRUE 場合、クライアントはダウンロードの完了時にバッファーを解放できます。 FALSE 場合、クライアントはアンロードされるまでバッファーを解放できません。 詳細については、次の「解説」セクションを参照してください。

備考

KSPROPERTY_SYNTH_DLS_DOWNLOAD get-property 要求を処理する場合、シンセサイザー ミニポート ドライバーは、SYNTHDOWNLOAD 構造体を使用してハンドルをクライアントに渡します。 このハンドルは、ダウンロードされた DLS データを一意に識別します。 クライアントは、後で DLS データをアンロード KSPROPERTY_SYNTH_DLS_UNLOAD set-property 要求で同じハンドルを指定します。

ミニポート ドライバーは、DLS データの独自のコピーを作成する場合は、KSPROPERTY_SYNTH_DLS_DOWNLOADプロパティ要求が完了するとすぐにクライアントが DLS データを含むバッファーを解放できることを示す TRUE Free パラメーターを設定します。 ただし、ミニポート ドライバーが DLS データのクライアントのコピーを使用し続ける場合は、KSPROPERTY_SYNTH_DLS_UNLOADプロパティ要求を送信してデータをアンロードするまで、クライアントが元の DLS データ バッファーの割り当てを維持する必要があることを示す FALSE Free を設定します。

必要条件

要件 価値
ヘッダー dmusprop.h (Dmusprop.h を含む)

関連項目

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD