Estructura SYNTHDOWNLOAD (dmusprop.h)
La estructura SYNTHDOWNLOAD especifica un identificador para los datos DLS descargados. También especifica si el búfer que contiene los datos DLS se puede liberar.
Sintaxis
typedef struct _SYNTHDOWNLOAD {
HANDLE DownloadHandle;
BOOL Free;
} SYNTHDOWNLOAD, *PSYNTHDOWNLOAD;
Miembros
DownloadHandle
Controle el búfer de datos DLS descargado, que el controlador de miniporte 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 en cuanto se complete la descarga de DLS. Si TRUE, el cliente puede liberar el búfer cuando se complete la descarga. Si FALSE, el cliente no debe liberar el búfer hasta que se descargue. Para obtener más información, vea la siguiente sección Comentarios.
Observaciones
Al procesar una solicitud de KSPROPERTY_SYNTH_DLS_DOWNLOAD 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 DLS descargados. El cliente especifica más adelante este mismo identificador en KSPROPERTY_SYNTH_DLS_UNLOAD solicitud set-property que descarga los datos DLS.
Si el controlador de miniporte 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 la propiedad KSPROPERTY_SYNTH_DLS_DOWNLOAD. Si el controlador de miniporte sigue usando la copia del cliente de los datos DLS, sin embargo, 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 enviando una solicitud de propiedad KSPROPERTY_SYNTH_DLS_UNLOAD.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | dmusprop.h (incluya Dmusprop.h) |