Structure SYNTHDOWNLOAD (dmusprop.h)
La structure SYNTHDOWNLOAD spécifie un handle pour les données DLS téléchargées. Il spécifie également si la mémoire tampon contenant les données DLS peut être libérée.
Syntaxe
typedef struct _SYNTHDOWNLOAD {
HANDLE DownloadHandle;
BOOL Free;
} SYNTHDOWNLOAD, *PSYNTHDOWNLOAD;
Membres
DownloadHandle
Gérez la mémoire tampon de données DLS téléchargée, que le pilote miniport génère pour identifier de manière unique les données DLS afin qu’elles puissent être déchargées ultérieurement.
Free
Spécifie si le client peut libérer la mémoire tampon de données dès que le téléchargement DLS est terminé. Si la valeur EST TRUE, le client peut libérer la mémoire tampon une fois le téléchargement terminé. Si la valeur est FALSE, le client ne doit pas libérer la mémoire tampon tant qu’elle n’est pas déchargée. Pour plus d'informations, consultez la section Notes qui suit.
Remarques
Lors du traitement d’une requête get-property KSPROPERTY_SYNTH_DLS_DOWNLOAD , le pilote miniport du synthétiseur utilise la structure SYNTHDOWNLOAD pour transmettre un handle au client. Ce handle identifie de manière unique les données DLS téléchargées. Le client spécifie ultérieurement ce même handle dans KSPROPERTY_SYNTH_DLS_UNLOAD demande set-property qui décharge les données DLS.
Si le pilote miniport effectue sa propre copie des données DLS, il définit le paramètre Free sur TRUE pour indiquer que le client peut libérer la mémoire tampon contenant les données DLS dès que la demande de propriété KSPROPERTY_SYNTH_DLS_DOWNLOAD se termine. Si le pilote miniport continue d’utiliser la copie du client des données DLS, il définit Free sur FALSE pour indiquer que le client doit conserver son allocation de la mémoire tampon de données DLS d’origine jusqu’à ce qu’il décharge les données en envoyant une demande de propriété KSPROPERTY_SYNTH_DLS_UNLOAD.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dmusprop.h (inclure Dmusprop.h) |