Функция PcDispatchIrp (portcls.h)

Функция PcDispatchIrp отправляет IRP обработчику системного драйвера PortCls по умолчанию.

Синтаксис

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

Параметры

[in] pDeviceObject

Указатель на объект устройства. Этот параметр должен указывать на системную структуру типа DEVICE_OBJECT.

[in] pIrp

Указатель на IRP, который должен быть отправлен

Возвращаемое значение

PcDispatchIrp возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки.

Замечания

В рамках процесса инициализации функция pcInitializeAdapterDriver загружает указатели на обработчики для нескольких IRP в объект драйвера. После вызова PcInitializeAdapterDriverдрайвер адаптера может перезаписать один или несколько указателей обработчика PortCls указателями на собственные обработчики IRP.

Если после получения IRP обработчик IRP адаптера определяет, что обработчик IRP адаптера должен обрабатываться обработчиком IRP PortCls, обработчик драйвера адаптера вызывает PcDispatchIrp для пересылки IRP в обработчик PortCls.

Пример кода см. в примере звукового драйвера SB16 в комплекте драйверов Microsoft Windows (WDK).

Требования

См. также

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver