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

Confira também

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD