Função PcForwardIrpSynchronous (portcls.h)
A função PcForwardIrpSynchronous é usada por manipuladores IRP para encaminhar IRPs plug and play para o de objeto de dispositivo físico (PDO).
Sintaxe
PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Parâmetros
[in] DeviceObject
Ponteiro para o objeto do dispositivo de áudio. Esse parâmetro deve apontar para uma estrutura do sistema do tipo DEVICE_OBJECT.
[in] Irp
Ponteiro para o IRP que deve ser encaminhado
Valor de retorno
pcForwardIrpSynchronous retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.
Observações
pcForwardIrpSynchronous faz com que o próximo PDO receba o IRP e bloqueie até que o IRP seja concluído pelo driver de dispositivo físico. Nesse ponto, pcForwardIrpSynchronous desbloqueia e retorna ao chamador. O chamador (um manipulador IRP) deve eventualmente retornar, possivelmente com um status de STATUS_PENDING. Em geral, qualquer manipulador IRP que chame essa função deve especificar a ação IRP_ACTION_FINISH ao retornar. Qualquer outra ação resultaria no encaminhamento do IRP para o dispositivo físico uma segunda vez.
A função PcCompleteIrp é usada quando um manipulador IRP retorna STATUS_PENDING e o IRP deve ser concluído posteriormente.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O driver do sistema PortCls implementa a função PcForwardIrpSynchronous no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores. |
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h (inclua Portcls.h) |
| biblioteca | Portcls.lib |
| IRQL | PASSIVE_LEVEL |