KsPinSubmitFrameMdl-Funktion (ks.h)

Wenn ein Pin durch einen Aufruf von KsPinRegisterFrameReturnCallback in den Einschleusungsmodus versetzt wurde, sendet die KsPinSubmitFrameMdl-Funktion einen Frame direkt an die Transportleitung.

Syntax

KSDDKAPI NTSTATUS KsPinSubmitFrameMdl(
  [in]           PKSPIN           Pin,
  [in, optional] PMDL             Mdl,
  [in, optional] PKSSTREAM_HEADER StreamHeader,
  [in, optional] PVOID            Context
);

Parameter

[in] Pin

Ein Zeiger auf eine KSPIN-Struktur , die den Pin darstellt, an dem ein Frame übermittelt werden soll.

[in, optional] Mdl

Ein Zeiger auf eine Speicherdeskriptorliste, die den Framepuffer beschreibt. Optional.

[in, optional] StreamHeader

Ein Zeiger auf eine KSSTREAM_HEADER Struktur. Der Streamheader wird kopiert, wenn dieser Parameter angegeben wird. Optional.

[in, optional] Context

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der an den über KsPinRegisterFrameReturnCallback registrierten Framerückruf übergeben wird. Dieser Parameter ist optional und dient ausschließlich der Verwendung durch den Aufrufer.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn die Frameübermittlung erfolgreich ist. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Hinweise

Der Unterschied zwischen dieser Funktion und KsPinSubmitFrame besteht darin, dass diese Funktion einen Frame mit einer MDL-Struktur und nicht mit einem Daten- und Größenargument übermittelt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen.
Zielplattform Universell
Header ks.h (einschließlich Ks.h)
Bibliothek Ks.lib
IRQL <=DISPATCH_LEVEL

Weitere Informationen

KsPinRegisterFrameReturnCallback

KsPinSubmitFrame