Estrutura SYNTHDOWNLOAD (dmusprop.h)
A estrutura SYNTHDOWNLOAD especifica um identificador para dados DLS baixados. Ele também especifica se o buffer que contém os dados DLS pode ser liberado.
Sintaxe
typedef struct _SYNTHDOWNLOAD {
HANDLE DownloadHandle;
BOOL Free;
} SYNTHDOWNLOAD, *PSYNTHDOWNLOAD;
Membros
DownloadHandle
Manipule para o buffer de dados DLS baixado, que o driver de miniporto gera para identificar exclusivamente os dados DLS para que possam ser descarregados posteriormente.
Free
Especifica se o cliente pode liberar o buffer de dados assim que o download do DLS for concluído. Se TRUE, o cliente poderá liberar o buffer quando o download for concluído. Se FALSE, o cliente não deverá liberar o buffer até que ele seja descarregado. Para obter mais informações, consulte a seção Comentários a seguir.
Comentários
Ao processar um KSPROPERTY_SYNTH_DLS_DOWNLOAD solicitação get-property, o driver de miniporte do sintetizador usa a estrutura SYNTHDOWNLOAD para passar um identificador de volta para o cliente. Esse identificador identifica exclusivamente os dados DLS baixados. Posteriormente, o cliente especifica esse mesmo identificador em KSPROPERTY_SYNTH_DLS_UNLOAD solicitação set-property que descarrega os dados DLS.
Se o driver de miniporto fizer sua própria cópia dos dados DLS, ele definirá o parâmetro Free como TRUE para indicar que o cliente pode liberar o buffer que contém os dados DLS assim que a solicitação de propriedade KSPROPERTY_SYNTH_DLS_DOWNLOAD for concluída. No entanto, se o driver de miniporto continuar a usar a cópia dos dados DLS do cliente, ele definirá Free como FALSE para indicar que o cliente deve manter sua alocação do buffer de dados DLS original até descarregar os dados enviando uma solicitação de propriedade KSPROPERTY_SYNTH_DLS_UNLOAD.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | dmusprop.h (inclua Dmusprop.h) |