Função PcDispatchIrp (portcls.h)

A função PcDispatchIrp envia um IRP para o manipulador padrão do driver do sistema PortCls.

Sintaxe

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

Parâmetros

[in] pDeviceObject

Ponteiro para o objeto 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 despachado

Retornar valor

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

Comentários

Como parte de seu processo de inicialização, a função PcInitializeAdapterDriver carrega ponteiros para manipuladores de vários IRPs no objeto driver. Após a chamada para PcInitializeAdapterDriver, um driver de adaptador pode optar por substituir um ou mais ponteiros do manipulador PortCls com ponteiros para seus próprios manipuladores IRP.

Se, depois de receber um IRP, o manipulador IRP do driver do adaptador determinar que o IRP deve ser manipulado pelo manipulador IRP PortCls, o manipulador do driver do adaptador chamará PcDispatchIrp para encaminhar o IRP para o manipulador PortCls.

Para obter um exemplo de código, consulte o driver de áudio de exemplo SB16 no WDK (Microsoft Windows Driver Kit).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	O driver do sistema PortCls implementa a função PcDispatchIrp no Microsoft Windows 98/Me e nos sistemas operacionais Windows 2000 e posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h
Biblioteca	Portcls.lib
IRQL	PASSIVE_LEVEL

Confira também

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver