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 数据。 客户端稍后在 KSPROPERTY_SYNTH_DLS_UNLOAD 卸载 DLS 数据的 set-property 请求中指定此相同的句柄。
如果微型端口驱动程序创建自己的 DLS 数据副本，它将 Free 参数设置为 TRUE，以指示客户端可以在KSPROPERTY_SYNTH_DLS_DOWNLOAD属性请求完成后立即释放包含 DLS 数据的缓冲区。 但是，如果微型端口驱动程序继续使用客户端的 DLS 数据副本，它将 免费 设置为 FALSE，以指示客户端应保持其原始 DLS 数据缓冲区的分配，直到它通过发送KSPROPERTY_SYNTH_DLS_UNLOAD属性请求来卸载数据。
要求
| 要求 | 价值 |
|---|---|
| 标头 | dmusprop.h （包括 Dmusprop.h） |