PcForwardIrpSynchronous-Funktion (portcls.h)

Die PcForwardIrpSynchronous-Funktion wird von IRP-Handlern verwendet, um Plug and 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_OBJECTverweisen.

[in] Irp

Zeiger auf die IRP-, die weitergeleitet werden soll

Rückgabewert

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

Bemerkungen

PcForwardIrpSynchronous bewirkt, dass der nächste PDO das IRP empfängt und blockiert, bis der IRP vom physischen Gerätetreiber abgeschlossen wurde. An diesem Punkt entsperrt PcForwardIrpSynchronous die Blockierung und kehrt zum Aufrufer zurück. Der Aufrufer (ein IRP-Handler) sollte schließlich zurückgegeben werden – möglicherweise mit einem Status von STATUS_PENDING. Im Allgemeinen muss jeder IRP-Handler, der diese Funktion aufruft, die Aktion IRP_ACTION_FINISH beim Zurückgeben angeben. Jede andere Aktion würde dazu führen, dass das 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 das IRP später abgeschlossen werden muss.

Anforderungen

Siehe auch

DEVICE_OBJECT

IRP-

PcCompleteIrp-