PcDispatchIrp-Funktion (portcls.h)

Die PcDispatchIrp-Funktion sendet eine 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_OBJECT verweisen.

[in] pIrp

Zeiger auf das zu sendende IRP

Rückgabewert

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

Hinweise

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

Wenn der IRP-Handler des Adaptertreibers nach dem Empfangen eines IRP feststellt, dass die IRP stattdessen vom PortCls-IRP-Handler verarbeitet werden soll, ruft der Handler des Adaptertreibers PcDispatchIrp auf, um den IRP an den PortCls-Handler weiterzuleiten.

Ein Codebeispiel finden Sie im SB16-Beispiel-Audiotreiber im Microsoft Windows Driver Kit (WDK).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Der PortCls-Systemtreiber implementiert die PcDispatchIrp-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höheren Betriebssystemen.
Zielplattform	Universell
Header	portcls.h
Bibliothek	Portcls.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver