PFNKSDEVICEIRP-Rückruffunktion (ks.h)
Die IRP-Handlerroutine eines AVStream-Minitreibers wird aufgerufen, wenn diese IRPs vom Gerät gesendet werden.
Syntax
PFNKSDEVICEIRP Pfnksdeviceirp;
NTSTATUS Pfnksdeviceirp(
[in] PKSDEVICE Device,
[in] PIRP Irp
)
{...}
Parameter
[in] Device
Zeiger auf den KSDEVICE , der die IRP versendet hat.
[in] Irp
Der vom Gerät ausgestellte IRP.
Rückgabewert
Sollte STATUS_SUCCESS oder den Fehlercode zurückgeben, der vom Versuch zurückgegeben wurde, den Vorgang auszuführen. Wenn dies nicht der Fall ist, geben Sie einen entsprechenden Fehlercode zurück.
Hinweise
| IRP | BESCHREIBUNG |
|---|---|
| IRP_MN_QUERY_REMOVE_DEVICE | Der Minidriver gibt die Adresse dieser Routine im QueryRemove-Element der KSDEVICE_DISPATCH-Struktur an. Diese Routine wird aufgerufen, wenn eine IRP_MN_QUERY_REMOVE_DEVICE vom Gerät bereitgestellt wird. Es wird in der Regel von Minitreibern bereitgestellt, die das Entfernen des Geräts verhindern möchten, oder von Minitreibern, die Aktivitäten verbieten müssen, die andernfalls verhindern würden, dass sie sich zu einem Vorgang zum Entfernen des Geräts verpflichten. Wenn diese Routine nicht bereitgestellt wird, geht AVStream davon aus, dass das Gerät zu einer Entfernung committet werden kann. Die Routine wird unter IRQL = PASSIVE_LEVEL aufgerufen und gibt möglicherweise keine STATUS_PENDING zurück. ein Erfolgscode gibt an, dass das Gerät zu einer Entfernung committet werden kann, und ein Fehlercode gibt an, dass dies 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 stören. Diese Routine ist optional. |
| IRP_MN_QUERY_STOP_DEVICE | Der Minitreiber 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 zuzulassen, die den Minitreiber daran hindern würden, sich zu einem Stoppvorgang zu verpflichten. Wenn diese Routine nicht angegeben ist, geht AVStream davon aus, dass der Minitreiber zu einem Stoppvorgang committet werden kann. Diese Routine ist optional. Success gibt an, dass das Gerät zu einem Stopp committet werden kann, und ein Fehlercode gibt an, dass dies 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 zu einer Schnittstelle abzurufen, die von Ihrem Treiber exportiert wird. Weitere Informationen zum IRP finden Sie unter IRP_MN_QUERY_INTERFACE. Der Minidriver gibt die Adresse dieser Routine im QueryInterface-Element der KSDEVICE_DISPATCH-Struktur an. Diese Routine ist optional. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ks.h (ks.h einschließen) |
| IRQL | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |