共用方式為

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)

另請參閱

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD