Interface IKsPropertySet

[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.]

L’interface IKsPropertySet a été conçue à l’origine comme un moyen efficace de définir et de récupérer les propriétés des appareils sur les pilotes WDM, en utilisant KSProxy pour traduire les appels de méthode COM en mode utilisateur en jeux de propriétés en mode noyau utilisés par les pilotes de classe de streaming WDM. Cette interface est désormais également utilisée pour transmettre des informations strictement entre les composants logiciels.

Dans certains cas, les composants logiciels doivent implémenter cette interface, ou bien l’interface IKsControl (documentée dans le DDK DirectShow). Par exemple, si vous écrivez un décodeur MPEG-2 logiciel à utiliser avec le navigateur DVD, vous devez implémenter l’une de ces interfaces et prendre également en charge les jeux de propriétés liés au DVD que le navigateur enverra au décodeur. Les broches peuvent prendre en charge l’une de ces interfaces pour permettre à d’autres broches ou filtres de définir ou de récupérer leurs propriétés.

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.

 

Membres

L’interface IKsPropertySet hérite de l’interface IUnknown. IKsPropertySet a également les types de membres suivants :

• Méthodes

Méthodes

L’interface IKsPropertySet a ces méthodes.

Méthode	Description
Obtenir	Récupère une propriété identifiée par un GUID de jeu de propriétés et un ID de propriété.
QuerySupported	Détermine si un objet prend en charge un jeu de propriétés spécifié.
Définissez	Définit une propriété identifiée par un GUID de jeu de propriétés et un ID de propriété.

 

Notes

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

Jeux de propriétés