Share via

Struttura REGFILTERPINS (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La REGFILTERPINS struttura contiene informazioni sui pin per la registrazione di un filtro.

Sintassi

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;

Members

strName

Nome del pin. (Obsoleto).

bRendered

Se TRUE, il filtro esegue il rendering dell'input da questo pin. (Si applica solo ai pin di input. Per i pin di output, il valore è sempre FALSE.

bOutput

Se TRUE, questo pin è un pin di output. In caso contrario, il pin è un pin di input.

bZero

Se TRUE, il filtro può avere zero istanze di questo pin.

bMany

Se TRUE, il filtro può creare più di un'istanza di questo tipo di pin.

clsConnectsToFilter

Identificatore di classe (CLSID) del filtro a cui si connette questo pin. (Obsoleto).

strConnectsToPin

Nome del pin a cui si connette questo pin. (Obsoleto).

nMediaTypes

Numero di tipi di supporti supportati da questo pin.

lpMediaType

Puntatore a una matrice di strutture REGPINTYPES di dimensioni nMediaTypes.

Commenti

Questa struttura viene utilizzata nell'interfaccia IFilterMapper2 per la registrazione del filtro. Se si usa questa struttura, impostare il membro dwVersion della struttura REGFILTER2 su 1. Se è necessario registrare una categoria media o pin per il pin, usare invece la struttura REGFILTERPINS2 . In tal caso, impostare il membro dwVersion della struttura REGFILTER2 su 2.

Il tipo di AMOVIESETUP_PIN equivalente viene usato nei modelli di class factory (CFactoryTemplate).

I membri strName, clsConnectsToFilter e strConnectsToPin sono obsoleti. I relativi valori non vengono aggiunti al Registro di sistema.

Per altre informazioni, vedere Come registrare i filtri DirectShow.

Requisiti

Requisito Valore
Intestazione strmif.h (include Dshow.h)

Vedi anche

Strutture DirectShow