KsPinRegisterFrameReturnCallback-Funktion (ks.h)
Die KsPinRegisterFrameReturnCallback -Funktion registriert einen Framerückruf mit 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 Einfüfmodus einfügen möchten, indem Sie einen Framerückruf registrieren.
[in] FrameReturn
Dieser Parameter stellt die Adresse eines von minidriver bereitgestellten AVStrMiniFrameReturn Routine bereit.
Rückgabewert
Nichts
Bemerkungen
Wenn ein Pin einen Framerückruf vor dem Übergang von KSSTATE_STOP zu KSSTATE_ACQUIRE registriert hat, wird der Pin in den Einfügungsmodus versetzt. Dies weist darauf hin, dass der Pin keine Puffer empfängt und sie ausfüllt, sondern datenframes mithilfe KsPinSubmitFrame oder KsPinSubmitFrameMdlmanuell in den Schaltkreis einfügt. Wenn der Datenrahmen seine Reise um den Schaltkreis abschließt und zum Pin zurückkehrt, an dem es übermittelt wurde, wird es von AVStream wiederverwendet, indem AVStrMiniFrameReturnaufgerufen wird.
Minidriver, die diese Funktion aufrufen, sind direkt für das Einfügen von Frames in den Schaltkreis verantwortlich; Sie empfangen keine Puffer, die ausgefüllt werden sollen, und interagieren nicht direkt mit der Warteschlange, wie die meisten Minidriver. Beachten Sie außerdem, dass der Framerückruf vor dem Erstellen des Kernelpipelineabschnitts registriert werden soll. Der Kernelpipelineabschnitt wird erstellt, wenn der Pin zu KSSTATE_ACQUIRE wechselt. Weitere Informationen finden Sie unter Frame Injection.
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- | PASSIVE_LEVEL |