KsPinRegisterFrameReturnCallback-Funktion (ks.h)
Die KsPinRegisterFrameReturnCallback-Funktion registriert einen Framerückruf bei AVStream für einen bestimmten Pin.
Syntax
void KsPinRegisterFrameReturnCallback(
[in] PKSPIN Pin,
[in] PFNKSPINFRAMERETURN FrameReturn
);
Parameter
[in] Pin
Ein Zeiger auf die AVStream KSPIN-Struktur , die Sie in den Einschleusungsmodus versetzen möchten, indem Sie einen Framerückruf registrieren.
[in] FrameReturn
Dieser Parameter gibt die Adresse einer von minidriver bereitgestellten AVStrMiniFrameReturn-Routine an.
Rückgabewert
Keine
Bemerkungen
Wenn ein Pin vor dem Übergang von KSSTATE_STOP zu KSSTATE_ACQUIRE einen Framerückruf registriert hat, wird der Pin in den Einschleusungsmodus versetzt. Dies bedeutet, dass der Pin keine Puffer empfängt und ausfüllt, sondern datenframes mithilfe von KsPinSubmitFrame oder KsPinSubmitFrameMdl manuell in die Leitung einschleust. Wenn der Datenrahmen seinen Umweg um die Leitung abgeschlossen hat und zu dem Pin zurückkehrt, an dem er übermittelt wurde, wird er von AVStream durch Aufrufen von AVStrMiniFrameReturn wiederverwendet.
Minidriver, die diese Funktion aufrufen, sind direkt für das Einfügen von Frames in die Leitung verantwortlich; sie empfangen keine Puffer zum Füllen und interagieren nicht direkt mit der Warteschlange, wie die meisten Minitreiber. Beachten Sie auch, dass der Framerückruf vor dem Erstellen des Kernelpipeabschnitts registriert werden sollte. Der Kernelpipeabschnitt wird erstellt, wenn der Pin auf KSSTATE_ACQUIRE übergehen. Weitere Informationen finden Sie unter Frame Injection.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |