Metodo IMpeg2Demultiplexer::CreateOutputPin (strmif.h)

Articolo
07/28/2023

[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.

Il CreateOutputPin metodo crea un nuovo pin di output in Demux.

Sintassi

HRESULT CreateOutputPin(
  [in]  AM_MEDIA_TYPE *pMediaType,
  [in]  LPWSTR        pszPinName,
  [out] IPin          **ppIPin
);

Parametri

[in] pMediaType

Puntatore a una struttura AM_MEDIA_TYPE che specifica le informazioni sul tipo di supporto per il nuovo pin.

[in] pszPinName

Puntatore a una stringa di caratteri wide che specifica un nome per il nuovo pin. La lunghezza massima è di 128 caratteri, incluso il carattere di terminazione NULL .

[out] ppIPin

Indirizzo di una variabile che riceve un puntatore all'interfaccia IPin del pin.

Valore restituito

Restituisce un valore HRESULT . I valori restituiti possibili includono quanto segue.

Codice restituito	Descrizione
E_INVALIDARG	Argomento non valido.
S_OK	Operazione completata.
VFW_E_DUPLICATE_NAME	Nome pin duplicato.

Commenti

I nomi dei pin duplicati non sono consentiti. Per configurare il pin, eseguire una query sull'interfaccia IPin restituita per l'interfaccia IMPEG2StreamIdMap (per i flussi di programma) o per l'interfaccia IMPEG2PIDMap (per i flussi di trasporto). A seconda dell'interfaccia per cui viene eseguita una query sul primo pin di output, Demux si configura per la modalità di trasporto o flusso del programma. Dopo aver configurato Demux, tutte le chiamate a QueryInterface per recuperare l'altra interfaccia avranno esito negativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IMpeg2Demultiplexer

Condividi tramite