PcForwardIrpSynchronous-Funktion (portcls.h)
Die PcForwardIrpSynchronous-Funktion wird von IRP-Handlern verwendet, um Plug & Play IRPs an das physische Geräteobjekt (PDO) weiterzuleiten.
Syntax
PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Parameter
[in] DeviceObject
Zeiger auf das Geräteobjekt des Audiogeräts. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECT verweisen.
[in] Irp
Zeiger auf den IRP , der weitergeleitet werden soll
Rückgabewert
PcForwardIrpSynchronous gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben.
Hinweise
PcForwardIrpSynchronous bewirkt, dass das nächste PDO die IRP und den Block empfängt, bis die IRP vom physischen Gerätetreiber abgeschlossen wurde. An diesem Punkt hebt PcForwardIrpSynchronous die Blockierung auf und kehrt zum Aufrufer zurück. Der Aufrufer (ein IRP-Handler) sollte schließlich zurückgeben– möglicherweise mit einer status von STATUS_PENDING. Im Allgemeinen muss jeder IRP-Handler, der diese Funktion aufruft, die Aktion IRP_ACTION_FINISH bei der Rückgabe angeben. Jede andere Aktion würde dazu führen, dass der IRP ein zweites Mal an das physische Gerät weitergeleitet wird.
Die PcCompleteIrp-Funktion wird verwendet, wenn ein IRP-Handler STATUS_PENDING zurückgibt und die IRP später abgeschlossen werden muss.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Der PortCls-Systemtreiber implementiert die Funktion PcForwardIrpSynchronous in Microsoft Windows 98/Me und windows 2000 und höher. |
| Zielplattform | Universell |
| Header | portcls.h (portcls.h einschließen) |
| Bibliothek | Portcls.lib |
| IRQL | PASSIVE_LEVEL |