Structure REGFILTERPINS (strmif.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La 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.]
La REGFILTERPINS structure contient des informations de broche pour l’inscription d’un filtre.
Syntaxe
typedef struct REGFILTERPINS {
LPWSTR strName;
BOOL bRendered;
BOOL bOutput;
BOOL bZero;
BOOL bMany;
const CLSID *clsConnectsToFilter;
const WCHAR *strConnectsToPin;
UINT nMediaTypes;
const REGPINTYPES *lpMediaType;
} REGFILTERPINS;
Membres
strName
Nom de la broche. (Obsolète.)
bRendered
Si la valeur est TRUE, le filtre affiche l’entrée de cette broche. (S’applique uniquement aux broches d’entrée. Pour les broches de sortie, la valeur est toujours FALSE.)
bOutput
Si la valeur est TRUE, cette broche est une broche de sortie. Sinon, la broche est une broche d’entrée.
bZero
Si la valeur est TRUE, le filtre ne peut avoir aucune instance de cette broche.
bMany
Si la valeur est TRUE, le filtre peut créer plusieurs instance de ce type de broche.
clsConnectsToFilter
Identificateur de classe (CLSID) du filtre auquel cette broche se connecte. (Obsolète.)
strConnectsToPin
Nom de la broche à laquelle cette broche se connecte. (Obsolète.)
nMediaTypes
Nombre de types de médias pris en charge par cette broche.
lpMediaType
Pointeur vers un tableau de structures REGPINTYPES , de taille nMediaTypes.
Remarques
Cette structure est utilisée dans l’interface IFilterMapper2 pour l’inscription de filtre. Si vous utilisez cette structure, définissez le membre dwVersion de la structure REGFILTER2 sur 1. Si vous devez inscrire une catégorie de support ou de broche pour la broche, utilisez plutôt la structure REGFILTERPINS2 . Dans ce cas, définissez le membre dwVersion du REGFILTER2 structure sur 2.
Le type AMOVIESETUP_PIN équivalent est utilisé dans les modèles de fabrique de classes (CFactoryTemplate).
Les membres strName, clsConnectsToFilter et strConnectsToPin sont obsolètes . Leurs valeurs ne sont pas ajoutées au Registre.
Pour plus d’informations, consultez Comment inscrire des filtres DirectShow.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | strmif.h (include Dshow.h) |