SYNTHDOWNLOAD-Struktur (dmusprop.h)

  • Artikel

Die SYNTHDOWNLOAD-Struktur gibt ein Handle für heruntergeladene DLS-Daten an. Außerdem wird angegeben, ob der Puffer, der die DLS-Daten enthält, freigegeben werden kann.

Syntax

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

Member

DownloadHandle

Verarbeiten Sie den heruntergeladenen DLS-Datenpuffer, den der Miniporttreiber generiert, um die DLS-Daten eindeutig zu identifizieren, damit sie später entladen werden können.

Free

Gibt an, ob der Client den Datenpuffer freigeben kann, sobald der DLS-Download abgeschlossen ist. Bei TRUE kann der Client den Puffer freigeben, wenn der Download abgeschlossen ist. Bei FALSE darf der Client den Puffer erst freigeben, wenn er entladen wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Hinweise

Bei der Verarbeitung einer KSPROPERTY_SYNTH_DLS_DOWNLOAD get-property-Anforderung verwendet der Synthesizer-Miniporttreiber die SYNTHDOWNLOAD-Struktur, um ein Handle zurück an den Client zu übergeben. Dieses Handle identifiziert die heruntergeladenen DLS-Daten eindeutig. Der Client gibt später dasselbe Handle in KSPROPERTY_SYNTH_DLS_UNLOAD Set-Property-Anforderung an, die die DLS-Daten entladen.

Wenn der Miniporttreiber eine eigene Kopie der DLS-Daten erstellt, legt er den Free-Parameter auf TRUE fest, um anzugeben, dass der Client den Puffer mit den DLS-Daten freigeben kann, sobald die KSPROPERTY_SYNTH_DLS_DOWNLOAD-Eigenschaftsanforderung abgeschlossen ist. Wenn der Miniporttreiber jedoch weiterhin die Kopie der DLS-Daten des Clients verwendet, legt er Free auf FALSE fest, um anzugeben, dass der Client seine Zuordnung des ursprünglichen DLS-Datenpuffers beibehalten soll, bis er die Daten entladen, indem eine KSPROPERTY_SYNTH_DLS_UNLOAD-Eigenschaftsanforderung gesendet wird.

Anforderungen

Anforderung Wert
Header dmusprop.h (include Dmusprop.h)

Weitere Informationen

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD