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 |