Função PcCompleteIrp (portcls.h)

A função PcCompleteIrp conclui um IRP que foi marcado anteriormente como pendente.

Sintaxe

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

Parâmetros

[in] pDeviceObject

Ponteiro para o objeto de dispositivo do dispositivo. Esse parâmetro deve apontar para uma estrutura do sistema do tipo DEVICE_OBJECT.

[in] pIrp

Ponteiro para o IRP que deve ser concluído

[in] ntStatus

Especifica o status do IRP concluído. Consulte a lista de valores NTSTATUS definidos no arquivo de cabeçalho ntstatus.h.

Retornar valor

PcCompleteIrp retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Comentários

PcCompleteIrp é usado quando um manipulador IRP retorna STATUS_PENDING e o IRP deve ser concluído posteriormente. Quando o driver do adaptador conclui todo o processamento do IRP, ele chama PcCompleteIrp para concluir o IRP.

O manipulador IRP não deve chamar essa função. Em vez disso, o manipulador IRP de um driver de adaptador chama PcDispatchIrp para passar o IRP para o manipulador IRP do driver do sistema PortCls para executar todo o processamento restante do IRP.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	O driver do sistema PortCls implementa a função PcCompleteIrp no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)
Biblioteca	Portcls.lib
IRQL	<=DISPATCH_LEVEL

Confira também

DEVICE_OBJECT

IRP

IoCompleteRequest

PcDispatchIrp