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 を設定します。
要件
| 要件 | 値 |
|---|---|
| Header | dmusprop.h (Dmusprop.h を含む) |