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属性请求卸载数据为止。
要求
| 要求 | 值 |
|---|---|
| Header | dmusprop.h (包括 Dmusprop.h) |