Structure REGFILTERPINS (strmif.h)

  • 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 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)

Voir aussi

DirectShow Structures