estructura BUS_INTERFACE_STANDARD (wdm.h)

Artículo
02/27/2024

La estructura de la interfaz de BUS_INTERFACE_STANDARD permite a los controladores de dispositivo realizar llamadas directas a rutinas de controladores de autobús primarios. Esta estructura define la interfaz GUID_BUS_INTERFACE_STANDARD .

Sintaxis

typedef struct _BUS_INTERFACE_STANDARD {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PTRANSLATE_BUS_ADDRESS TranslateBusAddress;
  PGET_DMA_ADAPTER       GetDmaAdapter;
  PGET_SET_DEVICE_DATA   SetBusData;
  PGET_SET_DEVICE_DATA   GetBusData;
} BUS_INTERFACE_STANDARD, *PBUS_INTERFACE_STANDARD;

Miembros

Size

Tamaño, en bytes, de esta estructura.

Version

Versión de la interfaz definida por el controlador.

Context

Puntero a información de contexto específica de la interfaz.

InterfaceReference

Puntero a una rutina InterfaceReference que incrementa el recuento de referencias de la interfaz.

InterfaceDereference

Puntero a una rutina InterfaceDereference que disminuye el recuento de referencias de la interfaz.

TranslateBusAddress

Puntero a una rutina TranslateBusAddress que traduce las direcciones del bus primario a direcciones lógicas.

GetDmaAdapter

Puntero a una rutina GetDmaAdapter que devuelve una estructura del adaptador DMA (DMA_ADAPTER) para el dispositivo de destino.

SetBusData

Puntero a una rutina SetBusData que escribe datos en el espacio de configuración del dispositivo.

GetBusData

Puntero a una rutina GetBusData que lee los datos del espacio de configuración del dispositivo.

Comentarios

La estructura BUS_INTERFACE_STANDARD es una extensión de la estructura INTERFACE .

Algunas operaciones en un dispositivo están reservadas para el controlador de autobús primario del dispositivo. Estas operaciones pueden incluir el acceso al espacio de configuración específico del dispositivo de un bus o programar un controlador DMA.

Para leer o escribir en el espacio de configuración de un dispositivo, un controlador de dispositivo debe confiar en la agencia del controlador de autobús de dos maneras:

Mediante el envío de los paquetes de solicitud de E/S (IRP) IRP_MN_READ_CONFIG y IRP_MN_WRITE_CONFIG al controlador de autobús.
Al obtener una interfaz del conductor del autobús. A continuación, el controlador de dispositivo puede acceder al espacio de configuración de su dispositivo realizando llamadas directas a las rutinas del controlador de autobús proporcionadas por la estructura de interfaz de BUS_INTERFACE_STANDARD . Sus rutinas de miembro, GetBusData y SetBusData, se pueden usar para leer y escribir en el espacio de configuración de un dispositivo, respectivamente.

Para obtener más información sobre las formas de acceder al espacio de configuración, consulte Acceso al espacio de configuración de dispositivos.

Algunos tipos de dispositivos, como un dispositivo de almacenamiento de bus-mastering, tienen controladores DMA incorporados. Sin embargo, los controladores de dispositivo para estos dispositivos no pueden programar estos controladores DMA directamente. En su lugar, deben confiar en rutinas proporcionadas por el controlador de autobús primario. Para que un controlador de dispositivo programe el controlador DMA para su dispositivo, primero debe solicitar un objeto de adaptador desde el controlador de bus primario. El objeto de adaptador contiene las rutinas proporcionadas por el controlador de bus que se pueden usar para programar el controlador DMA del dispositivo. Los controladores de dispositivo deben confiar en el BUS_INTERFACE_STANDARD, ya sea directa o indirectamente, para obtener el objeto de adaptador.

Si el controlador se ejecuta en IRQL = PASSIVE_LEVEL, debe obtener el objeto de adaptador DMA de un dispositivo mediante una llamada a IoGetDmaAdapter. IoGetDmaAdapter detecta si el controlador de bus admite la interfaz BUS_INTERFACE_STANDARD . Si es así, IoGetDmaAdapter llama a la rutina a la que apunta el miembro GetDmaAdapter de esta interfaz para obtener el objeto de adaptador. De lo contrario, IoGetDmaAdapter llama a una rutina heredada equivalente.

Sin embargo, si un controlador debe obtener un objeto de adaptador mientras se ejecuta en IRQL >= DISPATCH_LEVEL, no puede hacerlo con IoGetDmaAdapter. En este caso, el controlador debe consultar la interfaz de BUS_INTERFACE_STANDARD mientras sigue en IRQL = PASSIVE_LEVEL mediante IRP_MN_QUERY_INTERFACE.