Función PcForwardIrpSynchronous (portcls.h)
Los controladores IRP usan la función PcForwardIrpSynchronous para reenviar Plug and Play IRP al objeto de dispositivo físico (PDO).
PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
[in] DeviceObject
Puntero al objeto de dispositivo del dispositivo de audio. Este parámetro debe apuntar a una estructura del sistema de tipo DEVICE_OBJECT.
[in] Irp
Puntero al IRP que se va a reenviar
PcForwardIrpSynchronous devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.
PcForwardIrpSynchronous hace que el siguiente PDO reciba el IRP y bloquee hasta que el controlador de dispositivo físico haya completado el IRP. En ese momento, PcForwardIrpSynchronous desbloquea y vuelve al autor de la llamada. El autor de la llamada (un controlador IRP) debe devolver, posiblemente, con un estado de STATUS_PENDING. En general, cualquier controlador IRP que llame a esta función debe especificar la acción IRP_ACTION_FINISH al devolver. Cualquier otra acción provocaría que el IRP se reenviase al dispositivo físico una segunda vez.
La función PcCompleteIrp se usa cuando un controlador IRP devuelve STATUS_PENDING y el IRP debe completarse más adelante.
Requisito | Value |
---|---|
Cliente mínimo compatible | El controlador del sistema PortCls implementa la función PcForwardIrpSynchronous en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores. |
Plataforma de destino | Universal |
Encabezado | portcls.h (incluir Portcls.h) |
Library | Portcls.lib |
IRQL | PASSIVE_LEVEL |