IMpeg2Demultiplexer::SetOutputPinMediaType-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetOutputPinMediaType -Methode aktualisiert den Medientyp des angegebenen Ausgabepins. (DirectX 9.0 und höher.)

Syntax

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

Parameter

[in] pszPinName

Der Anzeigename der Pin, der beim Erstellen der Pin in einem Aufruf von CreateOutputPin angegeben wurde.

[in] pMediaType

Zeiger auf eine AM_MEDIA_TYPE-Struktur , die die neuen Medientypinformationen für den Pin angibt.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Fehlercode zurück.

Hinweise

Pins können jederzeit mit einem neuen Medientyp neu konfiguriert werden. Wenn keine Verbindung vorhanden ist, wird der Medientyp einfach aktualisiert. Wenn der Pin verbunden ist, hängt der Erfolg oder Fehler des Aufrufs von der Annahme oder Ablehnung des angegebenen Medientyps durch den Nachgeschalteten Eingabenadel ab.

Der Medientyp wird vom Demultiplexer-Filter in keiner Weise interpretiert. Sie wird nur während der Verbindungsaushandlung durch den Ausgabenadel verwendet. Es hat keine Auswirkungen auf den Inhalt der Medienbeispiele. Medienbeispielinhalte werden definiert, wenn eine PID über den MEDIA_SAMPLE_CONTENT-Parameter in der IMPEG2PIDMap::MapPID-Methode oder über die definierten Werte in einem IMPEG2StreamIdMap::MapStreamIdId-Aufruf zugeordnet wird.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IMpeg2Demultiplexer-Schnittstelle