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 |