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

Weitere Informationen

DEVICE_OBJECT

IRP

PcCompleteIrp