PFNKSDEVICEIRP-Rückruffunktion (ks.h)

Artikel
02/07/2025

Die IRP-Handlerroutine eines AVStream Minidrivers wird aufgerufen, wenn diese IRPs vom Gerät verteilt werden.

Syntax

PFNKSDEVICEIRP Pfnksdeviceirp;

NTSTATUS Pfnksdeviceirp(
  [in] PKSDEVICE Device,
  [in] PIRP Irp
)
{...}

Parameter

[in] Device

Zeiger auf die KSDEVICE-, die das IRP versendet hat.

[in] Irp

Das von Deviceausgestellte IRP.

Rückgabewert

Sollte STATUS_SUCCESS oder den Fehlercode zurückgeben, der vom Versuch zum Ausführen des Vorgangs zurückgegeben wurde. Wenn dies nicht der Fall ist, geben Sie einen geeigneten Fehlercode zurück.

Bemerkungen

IRP	Beschreibung
IRP_MN_QUERY_REMOVE_DEVICE	Der Minidriver gibt die Adresse dieser Routine im QueryRemove- Mitglied der KSDEVICE_DISPATCH Struktur an. Diese Routine wird aufgerufen, wenn ein IRP_MN_QUERY_REMOVE_DEVICE vom Gerät verteilt wird. Es wird in der Regel von Minidrivern bereitgestellt, die das Entfernen des Geräts oder von Minidrivern verhindern möchten, die Aktivitäten verbieten müssen, die andernfalls verhindern würden, dass sie sich für einen Geräteentfernungsvorgang verpflichten. Wenn diese Routine nicht bereitgestellt wird, geht AVStream davon aus, dass das Gerät einen Commit für eine Entfernung ausführen kann. Die Routine wird bei IRQL = PASSIVE_LEVEL aufgerufen und kann STATUS_PENDING nicht zurückgeben; Ein Erfolgscode gibt an, dass das Gerät einen Commit auf eine Entfernung ausführen kann, und ein Fehlercode gibt an, dass es nicht möglich ist. Gibt erfolglos zurück, wenn das Gerät entfernt werden kann (oder Treiber aktualisiert werden können), ohne den Computer zu unterbrechen. Diese Routine ist optional.
IRP_MN_QUERY_STOP_DEVICE	Der Minidriver gibt einen Zeiger auf diese Routine im QueryStop Member seiner KSDEVICE_DISPATCH Struktur an. Verwenden Sie AVStrMiniQueryStop-, um das Beenden des Geräts zu verhindern oder aktivitäten zu verbieten, die verhindern würden, dass der Minidriver zu einem Stoppvorgang verpflichtet wird. Wenn diese Routine nicht angegeben ist, geht AVStream davon aus, dass der Minidriver einen Commit für einen Stoppvorgang ausführen kann. Diese Routine ist optional. Der Erfolg gibt an, dass das Gerät einen Commit auf einen Stopp ausführen kann, und ein Fehlercode gibt an, dass es nicht möglich ist. Geben Sie STATUS_PENDING nicht zurück.
IRP_MN_QUERY_INTERFACE	Ein Treiber oder eine Systemkomponente sendet dieses IRP, um Informationen über eine vom Treiber exportierte Schnittstelle abzurufen. Weitere Informationen zum IRP finden Sie unter IRP_MN_QUERY_INTERFACE. Der Minidriver gibt die Adresse dieser Routine im QueryInterface Member seiner KSDEVICE_DISPATCH Struktur an. Diese Routine ist optional.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	ks.h (enthalten Ks.h)
IRQL-	PASSIVE_LEVEL (Siehe Abschnitt "Hinweise")

Siehe auch

KSDEVICE-

KSDEVICE_DISPATCH

Freigeben über