PcDispatchIrp-Funktion (portcls.h)

Die PcDispatchIrp--Funktion verteilt ein IRP an den Standardhandler des PortCls-Systemtreibers.

Syntax

PORTCLASSAPI NTSTATUS PcDispatchIrp(
  [in] PDEVICE_OBJECT pDeviceObject,
  [in] PIRP           pIrp
);

Parameter

[in] pDeviceObject

Zeiger auf das Geräteobjekt. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECTverweisen.

[in] pIrp

Zeiger auf die IRP-, die versendet werden soll

Rückgabewert

PcDispatchIrp- gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Bemerkungen

Im Rahmen des Initialisierungsprozesses lädt der PcInitializeAdapterDriver-Funktion Zeiger auf Handler für mehrere IRPs in das Treiberobjekt. Nach dem Aufruf von PcInitializeAdapterDriverkann ein Adaptertreiber auswählen, einen oder mehrere PortCls-Handlerzeiger mit Zeigern auf seine eigenen IRP-Handler zu überschreiben.

Wenn der IRP-Handler des Adaptertreibers nach dem Empfang eines IRP-Handlers bestimmt, dass das IRP stattdessen vom PortCls IRP-Handler behandelt werden soll, ruft der Handler des Adaptertreibers PcDispatchIrp auf, um das IRP an den PortCls-Handler weiterzuleiten.

Ein Codebeispiel finden Sie unter dem SB16-Beispielaudiotreiber im Microsoft Windows Driver Kit (WDK).

Anforderungen

Siehe auch

DEVICE_OBJECT

IRP-

PcInitializeAdapterDriver-