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 數據的 set-property 要求中指定這個相同的句 KSPROPERTY_SYNTH_DLS_UNLOAD 柄。
如果迷你埠驅動程式建立自己的 DLS 數據複本，它會將 Free 參數設定為 TRUE ，表示用戶端可以在KSPROPERTY_SYNTH_DLS_DOWNLOAD屬性要求完成時立即釋放包含 DLS 數據的緩衝區。 不過，如果迷你埠驅動程序繼續使用用戶端的 DLS 數據復本，則會將 Free 設定為 FALSE ，表示客戶端應該維護其原始 DLS 數據緩衝區的配置，直到傳送KSPROPERTY_SYNTH_DLS_UNLOAD屬性要求來卸除數據為止。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | dmusprop.h (包含 Dmusprop.h) |