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 |