IKsPropertySet ::Get, méthode (dsound.h)

Article
03/05/2024

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 instance données pour la propriété .

[in] ulInstanceLength

Taille, en octets, de la mémoire tampon dans 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 dans PropertyData.

[out] pulBytesReturned

Pointeur vers une variable qui reçoit la taille, en octets, des données stockées dans la mémoire tampon dans PropertyData.

Valeur retournée

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, que Get remplit avec 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 BytesReturned.

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 d’IKsPropertySet est décrite dans les pages de référence DirectSound de la documentation Microsoft Windows SDK. Si une application doit inclure à la fois ksproxy.h et dsound.h, 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.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dsound.h (include Ksproxy.h, Dsound.h)

Voir aussi

IKsPropertySet ::Set

Partager via