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 VERDADEIRO, 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.
Observações
Ao processar uma solicitação de propriedade de obtenção KSPROPERTY_SYNTH_DLS_DOWNLOAD, o driver de miniporto 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 para 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. Se o driver de miniporto continuar a usar a cópia do cliente dos dados DLS, no entanto, ele definirá Gratuito para 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) |