Función PcCompleteIrp (portcls.h)

La función PcCompleteIrp completa un IRP que se marcó previamente como pendiente.

Sintaxis

PORTCLASSAPI NTSTATUS PcCompleteIrp(
  [in] PDEVICE_OBJECT pDeviceObject,
  [in] PIRP           pIrp,
  [in] NTSTATUS       ntStatus
);

Parámetros

[in] pDeviceObject

Puntero al objeto de dispositivo para el dispositivo. Este parámetro debe apuntar a una estructura del sistema de tipo DEVICE_OBJECT.

[in] pIrp

Puntero al IRP que se va a completar

[in] ntStatus

Especifica el estado del IRP completado. Vea la lista de valores NTSTATUS definidos en el archivo de encabezado ntstatus.h.

Valor devuelto

PcCompleteIrp devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

PcCompleteIrp se usa cuando un controlador IRP devuelve STATUS_PENDING y el IRP debe completarse más adelante. Cuando el controlador del adaptador finaliza todo el procesamiento del IRP, llama a PcCompleteIrp para completar el IRP.

El controlador IRP no debe llamar a esta función. En su lugar, el controlador IRP del controlador del adaptador llama a PcDispatchIrp para pasar el IRP al controlador IRP del controlador del sistema PortCls para realizar todo el procesamiento restante del IRP.

Requisitos

Consulte también

DEVICE_OBJECT

IRP

IoCompleteRequest

PcDispatchIrp