Metodo IFilterMapper::RegisterPin (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota L'interfaccia IFilterMapper è deprecata. Usare invece IFilterMapper2 .

Registra i dettagli del pin nel Registro di sistema.

Sintassi

HRESULT RegisterPin(
  [in] CLSID   Filter,
  [in] LPCWSTR Name,
  [in] BOOL    bRendered,
  [in] BOOL    bOutput,
  [in] BOOL    bZero,
  [in] BOOL    bMany,
  [in] CLSID   ConnectsToFilter,
  [in] LPCWSTR ConnectsToPin
);

Parametri

[in] Filter

GUID del filtro.

[in] Name

Nome del pin. Deve essere univoco all'interno del filtro. Non ha alcun significato diverso da indicare le informazioni sul tipo. Non è consigliabile usare nomi di pin più di 99 caratteri, perché questo causa problemi di enumerazione del filtro.

[in] bRendered

Valore che specifica se il filtro esegue il rendering di questo input. Impostare su TRUE se lo fa; in caso contrario, impostare su FALSE.

[in] bOutput

Valore che specifica se si tratta di un pin di output. Impostare su TRUE se è; in caso contrario, impostare su FALSE.

[in] bZero

Valore che specifica se il filtro può avere zero istanze di questo pin. Se può, impostare su TRUE; in caso contrario, impostare su FALSE. Ad esempio, un filtro di decompressione non deve creare un pin di output audio per un film senza una traccia audio.

[in] bMany

Valore che specifica se il filtro può avere molte istanze di questo pin. Se può, impostare su TRUE; in caso contrario, impostare su FALSE. Ad esempio, un mixer potrebbe avere più istanze del pin di input.

[in] ConnectsToFilter

Riservato. Deve essere NULL. (Questo è destinato a filtri come i mixer a livello di sistema che dispongono di connessioni all'esterno del grafico del filtro. Non è ancora implementato.

[in] ConnectsToPin

Riservato. Deve essere NULL.

Valore restituito

Restituisce un valore HRESULT .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Codici errore e esito positivo

Interfaccia IFilterMapper

Condividi tramite