Partager via


Property Sets (DirectShow)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans 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 capture audio/vidéo dans Media Foundation au lieu de directShow, lorsque cela est 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.]

Microsoft DirectShow utilise des ensembles de propriétés pour prendre en charge les services étendus proposés par le matériel et ses pilotes et filtres associés. Les fournisseurs de matériel et de filtre peuvent définir de nouvelles fonctionnalités en tant que propriétés, les organiser dans des jeux de propriétés et publier la spécification de ces jeux de propriétés. En tant que développeur d’applications, vous pouvez utiliser les méthodes de l’interface IKsPropertySet pour déterminer si un pilote ou un filtre prend en charge un ensemble particulier de propriétés, puis récupérer ou définir ces propriétés.

Toutes les méthodes exposées par IKsPropertySet nécessitent une GUID qui identifie le jeu de propriétés (le paramètre guidPropSet) et un DWORD qui identifie la propriété dans le jeu de propriétés (le paramètre dwPropID). Le paramètre dwPropID est généralement membre d’un type de données énuméré.

Les propriétés individuelles peuvent avoir des données associées que vous spécifiez dans le paramètre pPropData dans les méthodes IKsPropertySet ::Set et IKsPropertySet ::Get. Dans ces méthodes, les données de propriété sont typées en tant que pointeur vers void. Le type de données et la signification des données sont spécifiés dans la définition du jeu de propriétés.

Les sections suivantes fournissent des informations sur les jeux de propriétés pris en charge dans DirectShow :