Función PcDispatchIrp (portcls.h)

  • Artículo

La función PcDispatchIrp envía un IRP al controlador predeterminado del controlador del sistema PortCls.

Sintaxis

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

Parámetros

[in] pDeviceObject

Puntero al objeto de dispositivo. Este parámetro debe apuntar a una estructura del sistema de tipo DEVICE_OBJECT.

[in] pIrp

Puntero al IRP que se va a enviar

Valor devuelto

PcDispatchIrp devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

Como parte de su proceso de inicialización, la función PcInitializeAdapterDriver carga punteros a controladores para varios IRP en el objeto de controlador. Después de la llamada a PcInitializeAdapterDriver, un controlador de adaptador puede elegir sobrescribir uno o varios de los punteros del controlador PortCls con punteros a sus propios controladores IRP.

Si, después de recibir un IRP, el controlador IRP del controlador del adaptador determina que el controlador IRP debe ser controlado por el controlador IRP de PortCls en su lugar, el controlador del controlador del adaptador llama a PcDispatchIrp para reenviar el IRP al controlador PortCls.

Para obtener un ejemplo de código, vea el controlador de audio de ejemplo SB16 en el Kit de controladores de Microsoft Windows (WDK).

Requisitos

Requisito Value
Cliente mínimo compatible El controlador del sistema PortCls implementa la función PcDispatchIrp en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores.
Plataforma de destino Universal
Encabezado portcls.h
Library Portcls.lib
IRQL PASSIVE_LEVEL

Consulte también

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver