Struttura SYNTHDOWNLOAD (dmusprop.h)

La struttura SYNTHDOWNLOAD specifica un handle per i dati DLS scaricati. Specifica anche se il buffer contenente i dati DLS può essere liberato.

Sintassi

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

Members

DownloadHandle

Gestire il buffer dati DLS scaricato, che il driver miniport genera per identificare in modo univoco i dati DLS in modo che possa essere scaricato in un secondo momento.

Free

Specifica se il client può liberare il buffer dei dati non appena viene completato il download di DLS. Se TRUE, il client può liberare il buffer al termine del download. Se FALSE, il client non deve liberare il buffer finché non viene scaricato. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

Quando si elabora una richiesta di KSPROPERTY_SYNTH_DLS_DOWNLOAD get-property, il driver miniport di sintetizzatore usa la struttura SYNTHDOWNLOAD per passare un handle al client. Questo handle identifica in modo univoco i dati DLS scaricati. Il client specifica in seguito lo stesso handle in KSPROPERTY_SYNTH_DLS_UNLOAD richiesta di proprietà set che scarica i dati DLS.

Se il driver miniport esegue la propria copia dei dati DLS, imposta il parametro Free su TRUE per indicare che il client può liberare il buffer contenente i dati DLS non appena viene completata la richiesta di proprietà KSPROPERTY_SYNTH_DLS_DOWNLOAD. Se il driver miniport continua a usare la copia dei dati DLS del client, tuttavia, imposta Free su FALSE per indicare che il client deve mantenere l'allocazione del buffer dati DLS originale fino a quando non scarica i dati inviando una richiesta di proprietà KSPROPERTY_SYNTH_DLS_UNLOAD.

Requisiti

Requisito	Valore
Intestazione	dmusprop.h (includere Dmusprop.h)

Vedi anche

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD