Metodo IMpeg2Demultiplexer::SetOutputPinMediaType (strmif.h)

[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 SetOutputPinMediaType metodo aggiorna il tipo di supporto del pin di output specificato. (DirectX 9.0 e versioni successive).

Sintassi

HRESULT SetOutputPinMediaType(
  [in] LPWSTR        pszPinName,
  [in] AM_MEDIA_TYPE *pMediaType
);

Parametri

[in] pszPinName

Nome descrittivo del pin come specificato quando il pin è stato creato in una chiamata a CreateOutputPin.

[in] pMediaType

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

Valore restituito

Restituisce S_OK in caso di esito positivo. Se il metodo ha esito negativo, restituisce un codice di errore HRESULT .

Commenti

I pin possono essere riconfigurati in qualsiasi momento con un nuovo tipo di supporto. Se non esiste alcuna connessione, il tipo di supporto viene semplicemente aggiornato. Se il pin è connesso, l'esito positivo o negativo della chiamata dipenderà dall'accettazione o dal rifiuto del pin di input downstream del tipo di supporto specificato.

Il tipo di supporto non viene interpretato in alcun modo dal filtro Demultiplexer. Viene usato solo durante la negoziazione della connessione dal pin di output. Non ha alcun effetto sul contenuto degli esempi multimediali. Il contenuto di esempio multimediale viene definito quando viene eseguito il mapping di un PID tramite il parametro MEDIA_SAMPLE_CONTENT nel metodo IMPEG2PIDMap::MapPID o tramite i valori definiti in una chiamata IMPEG2StreamIdMap::MapStreamId .

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