Metodo IFilterMapper::RegisterPin (strmif.h)
[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.
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) |