Função PcForwardIrpSynchronous (portcls.h)

A função PcForwardIrpSynchronous é usada por manipuladores IRP para encaminhar Plug and Play IRPs para o 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 de dispositivo 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

Retornar valor

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

Comentários

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 faria com que o IRP fosse encaminhado 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

Confira também

DEVICE_OBJECT

IRP

PcCompleteIrp