IKsPropertySet ::Get, méthode (ksproxy.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 PropSet,
[in] ULONG Id,
[in] LPVOID InstanceData,
[in] ULONG InstanceLength,
[out] LPVOID PropertyData,
[in] ULONG DataLength,
[out] ULONG *BytesReturned
);
Paramètres
[in] PropSet
GUID qui identifie le jeu de propriétés.
[in] Id
Identificateur de la propriété dans le jeu de propriétés.
[in] InstanceData
Pointeur vers les données d’instance de la propriété.
[in] InstanceLength
Taille, en octets, de la mémoire tampon à InstanceData.
[out] PropertyData
Pointeur vers une mémoire tampon qui reçoit la valeur de la propriété.
[in] DataLength
Taille, en octets, de la mémoire tampon à PropertyData.
[out] BytesReturned
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. 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 | ksproxy.h (include Ksproxy.h, Dsound.h) |