IKsPropertySet ::Get, méthode (dsound.h)
La méthode Get récupère une propriété identifiée par un GUID de jeu de propriétés et un identificateur de propriété.
Syntaxe
HRESULT Get(
[in] REFGUID rguidPropSet,
[in] ULONG ulId,
[in] LPVOID pInstanceData,
[in] ULONG ulInstanceLength,
[out] LPVOID pPropertyData,
[in] ULONG ulDataLength,
[out] PULONG pulBytesReturned
);
Paramètres
[in] rguidPropSet
GUID qui identifie le jeu de propriétés.
[in] ulId
Identificateur de la propriété dans le jeu de propriétés.
[in] pInstanceData
Pointeur vers les données d’instance de la propriété.
[in] ulInstanceLength
Taille, en octets, de la mémoire tampon à InstanceData.
[out] pPropertyData
Pointeur vers une mémoire tampon qui reçoit la valeur de la propriété.
[in] ulDataLength
Taille, en octets, de la mémoire tampon à PropertyData.
[out] pulBytesReturned
Pointeur vers une variable qui reçoit la taille, en octets, des données qui Obtenir stocke dans la mémoire tampon à PropertyData.
Valeur de retour
Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.
Remarques
Pour récupérer une propriété, allouez une mémoire tampon, qui Obtenir remplit la propriété. Pour déterminer la taille de mémoire tampon nécessaire, spécifiez NULL pour PropertyData et zéro pour DataLength. La méthode Get retourne la taille de mémoire tampon requise dans octetsRe tourné.
Avertissement
Les fichiers d’en-tête ksproxy.h et dsound.h définissent des versions similaires mais incompatibles de l’interface IKsPropertySet. Les applications qui nécessitent le module proxy KS doivent utiliser la version définie dans ksproxy.h. La version DirectSound de IKsPropertySet est décrite dans les pages de référence DirectSound de la documentation du Kit de développement logiciel (SDK) Microsoft Windows. Si une application doit inclure à la fois ksproxy.h et dsound.h, quel que soit le fichier d’en-tête que le compilateur analyse en premier est celui dont la définition de IKsPropertySet est utilisée par le compilateur.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dsound.h (include Ksproxy.h, Dsound.h) |