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 を含む) |