Jeux de propriétés (DirectShow)

  • Article

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

Microsoft DirectShow utilise des jeux de propriétés pour prendre en charge les services étendus offerts par le matériel, ainsi que les 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 un GUID qui identifie le jeu de propriétés (paramètre guidPropSet ) et un DWORD qui identifie la propriété dans le jeu de propriétés (paramètre dwPropID ). Le paramètre dwPropID est généralement un membre d’un type de données énuméré.

Des 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 :