Estructura SYNTHDOWNLOAD (dmusprop.h)

La estructura SYNTHDOWNLOAD especifica un identificador para los datos DLS descargados. También especifica si se puede liberar el búfer que contiene los datos DLS.

Sintaxis

typedef struct _SYNTHDOWNLOAD {
  HANDLE DownloadHandle;
  BOOL   Free;
} SYNTHDOWNLOAD, *PSYNTHDOWNLOAD;

Miembros

DownloadHandle

Identificador del búfer de datos DLS descargado, que el controlador de minipuerto genera para identificar de forma única los datos DLS para que se puedan descargar más adelante.

Free

Especifica si el cliente puede liberar el búfer de datos tan pronto como se complete la descarga de DLS. Si es TRUE, el cliente puede liberar el búfer cuando se complete la descarga. Si es FALSE, el cliente no debe liberar el búfer hasta que se descargue. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Comentarios

Al procesar un KSPROPERTY_SYNTH_DLS_DOWNLOAD solicitud get-property, el controlador de miniporte del sintetizador usa la estructura SYNTHDOWNLOAD para devolver un identificador al cliente. Este identificador identifica de forma única los datos de DLS descargados. Más adelante, el cliente especifica este mismo identificador en KSPROPERTY_SYNTH_DLS_UNLOAD solicitud set-property que descarga los datos dls.

Si el controlador de minipuerto realiza su propia copia de los datos DLS, establece el parámetro Free en TRUE para indicar que el cliente puede liberar el búfer que contiene los datos DLS tan pronto como se complete la solicitud de propiedad KSPROPERTY_SYNTH_DLS_DOWNLOAD. Si el controlador de minipuerto sigue usando la copia del cliente de los datos DLS, establece Free en FALSE para indicar que el cliente debe mantener su asignación del búfer de datos DLS original hasta que descargue los datos mediante el envío de una solicitud de propiedad de KSPROPERTY_SYNTH_DLS_UNLOAD.

Requisitos

Requisito	Valor
Header	dmusprop.h (incluir Dmusprop.h)

Consulte también

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD