KsPinSubmitFrameMdl-Funktion (ks.h)
Wenn ein Pin durch einen Aufruf von KsPinRegisterFrameReturnCallbackin den Einfügemodus versetzt wurde, sendet die KsPinSubmitFrameMdl-Funktion einen Frame direkt an den Transportkreis.
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 Speicherbeschreibungsliste, die den Framepuffer beschreibt. Wahlfrei.
[in, optional] StreamHeader
Ein Zeiger auf eine KSSTREAM_HEADER Struktur. Der Datenstromheader wird kopiert, wenn dieser Parameter angegeben wird. Wahlfrei.
[in, optional] Context
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der an den Framerückruf übergeben wird, der über KsPinRegisterFrameReturnCallbackregistriert wurde. Dieser Parameter ist optional und dient ausschließlich der Verwendung des Aufrufers.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn die Frameübermittlung erfolgreich ist. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.
Bemerkungen
Der Unterschied zwischen dieser Funktion und KsPinSubmitFrame- besteht darin, dass diese Funktion einen Frame mithilfe einer MDL- Struktur statt eines Daten- und Größenarguments sendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | <=DISPATCH_LEVEL |