Función PcDispatchIrp (portcls.h)
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 |