PFNKSPIN-Rückruffunktion (ks.h)
Die Rückrufroutine eines AVStream-Minidrivers wird aufgerufen, wenn:
- Es stehen Daten für eine KSPIN- Struktur zur Verarbeitung zur Verfügung. Verwenden Sie diese Routine, um Pin-Centric Verarbeitungauszuführen.
- Die relevante KSPIN dient als Senken-Pin und ist mit einem AVStream-Quell-Pin verbunden.
Syntax
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
Parameter
[in] Pin
Zeigen Sie auf die KSPIN-, die Framedaten verarbeiten können.
Rückgabewert
Gibt STATUS_SUCCESS zurück, um die Verarbeitung fortzusetzen. Geben Sie STATUS_PENDING zurück, um die Verarbeitung bis zum nächsten auslösenden Ereignis zu beenden.
Bemerkungen
Über AVStrMiniPinProcess
Der Minidriver gibt die Adresse dieser Routine im Process Member seiner KSPIN_DISPATCH Struktur an.
Geben Sie an, dass ein Filter Pin-Centric Verarbeitung verwendet, indem diese Verteilerfunktion bereitgestellt wird. Der Minidriver legt pin flags in der relevanten KSPIN_DESCRIPTOR_EX Struktur fest, die bestimmen, wann AVStream AVStrMiniPinProcessaufruft. Wenn der Minidriver keine Flags im Deskriptor festlegt, ist das Standardverhalten, dass AVStream AVStrMiniPinProcess aufruft, wenn neue Daten in eine zuvor leere Warteschlange eintreffen. Weitere Informationen zur Verarbeitung von Triggern finden Sie unter Pin-Centric Verarbeitung.
Nach der Verarbeitung kann der Minidriver verhindern, dass der Frame durch Klonen des führenden Edgestreamzeigers abgeschlossen wird. Rufen Sie dazu KsStreamPointerClone-auf. Siehe führende und nachfolgende Edgestreamzeiger.
Geben Sie alternativ einen eindeutigen Hinterrand an, indem Sie KSPIN_FLAG_DISTINCT_TRAILING_EDGE für KSPIN_DESCRIPTOR_EXfestlegen. Eine dritte Option besteht darin, den Zeiger des führenden Edgedatenstroms nicht voranzutreiben.
Die Prozessverteilung erfolgt entweder an der STANDARD-IRQL = PASSIVE_LEVEL oder möglicherweise bei DISPATCH_LEVEL, wenn der Minidriver in der relevanten KSPIN_DESCRIPTOR_EXKSPIN_FLAG_DISPATCH_LEVEL_PROCESSING angegeben hat.
Diese Routine ist optional.
Über AVStrMiniPinConnect
Der Minidriver gibt die Adresse dieser Routine im Connect Member seiner KSPIN_DISPATCH Struktur an.
Gibt STATUS_SUCCESS oder den fehler zurück, der vom Versuch zurückgegeben wurde, eine intraverbindung herzustellen. Geben Sie STATUS_PENDING nicht zurück.
Diese Routine ist optional.
Siehe auch KS Pins.
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- | Desktop |
| Header- | ks.h (enthalten Ks.h) |
| IRQL- | (Siehe Abschnitt "Hinweise") |