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

Requisito	Value
Cliente mínimo compatible	El controlador del sistema PortCls implementa la función PcCompleteIrp 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	<=DISPATCH_LEVEL

Consulte también

DEVICE_OBJECT

IRP

IoCompleteRequest

PcDispatchIrp