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)

另请参阅

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD