IKsPropertySet::Set, méthode

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La Set méthode définit une propriété identifiée par un GUID d’ensemble de propriétés et un ID de propriété.

Syntaxe

HRESULT Set(
  [in] REFGUID guidPropSet,
  [in] DWORD   dwPropID,
  [in] LPVOID  pInstanceData,
  [in] DWORD   cbInstanceData,
  [in] LPVOID  pPropData,
  [in] DWORD   cbPropData
);

Paramètres

guidPropSet [in]: GUID du jeu de propriétés.
dwPropID [in]: Identificateur de la propriété dans le jeu de propriétés.
pInstanceData [in]: Pointeur vers une mémoire tampon qui contient instance données pour la propriété .
cbInstanceData [in]: Taille de la mémoire tampon pInstanceData , en octets.
pPropData [in]: Pointeur vers une mémoire tampon qui contient la valeur de la propriété .
cbPropData [in]: Sise de la mémoire tampon pPropData , en octets.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Opération réussie.
E_PROP_SET_UNSUPPORTED	Le jeu de propriétés n’est pas pris en charge.
E_PROP_ID_UNSUPPORTED	L’ID de propriété n’est pas pris en charge pour le jeu de propriétés spécifié.

Notes

Une autre interface de ce nom existe dans le fichier dsound.h en-tête. Les deux interfaces ne sont pas compatibles. L’interface IKsControl , documentée dans le DDK DirectShow, est désormais l’interface recommandée pour passer des jeux de propriétés entre les pilotes WDM et les composants en mode utilisateur.

Vous devez inclure Ks.h avant Ksproxy.h.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Ksproxy.h
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite
IKsPropertySet, interface
Jeux de propriétés

Partager via