Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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;
Angehörige
DownloadHandle
Behandeln 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. Wenn TRUE, kann der Client den Puffer freigeben, wenn der Download abgeschlossen ist. Wenn FALSE-, darf der Client den Puffer erst freigeben, wenn er entladen wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Bemerkungen
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. Mit diesem Handle werden die heruntergeladenen DLS-Daten eindeutig identifiziert. Der Client gibt später dieses Handle in KSPROPERTY_SYNTH_DLS_UNLOAD Set-Property-Anforderung an, mit dem die DLS-Daten entladen werden.
Wenn der Miniport-Treiber eine eigene Kopie der DLS-Daten erstellt, legt er den Parameter Free auf TRUE fest, um anzugeben, dass der Client den Puffer mit den DLS-Daten freigeben kann, sobald die KSPROPERTY_SYNTH_DLS_DOWNLOAD Eigenschaftenanforderung abgeschlossen ist. Wenn der Miniporttreiber weiterhin die Kopie der DLS-Daten des Clients verwendet, legt er jedoch Free auf FALSE- fest, um anzugeben, dass der Client die Zuordnung des ursprünglichen DLS-Datenpuffers beibehalten soll, bis die Daten durch Senden einer KSPROPERTY_SYNTH_DLS_UNLOAD Eigenschaftsanforderung entladen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dmusprop.h (include Dmusprop.h) |