estructura PCI_SLOT_NUMBER (wdm.h)

Artículo
02/27/2024

La estructura PCI_SLOT_NUMBER está obsoleta. Define el formato del parámetro Slot en las rutinas de HalXxxBusData obsoletas cuando se les llama con el valor BusDataTypePCIConfiguration.

Sintaxis

typedef struct _PCI_SLOT_NUMBER {
  union {
    struct {
      ULONG DeviceNumber : 5;
      ULONG FunctionNumber : 3;
      ULONG Reserved : 24;
    } bits;
    ULONG AsULONG;
  } u;
} PCI_SLOT_NUMBER, *PPCI_SLOT_NUMBER;

Miembros

u

u.bits

Especifica el dispositivo en particular en un adaptador multifunción en la ranura especificada que se está configurando. DeviceNumber indica el número de ranura lógica del adaptador; FunctionNumber indica el dispositivo determinado en ese adaptador.

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Especifica el número de ranura lógica del dispositivo que se está configurando.

Comentarios

Los controladores de dispositivos PCI pueden llamar a HalGetBusData o HalGetBusDataByOffset más de una vez para el mismo número de ranura para obtener la información de configuración de sus dispositivos.

Por ejemplo, un controlador podría buscar dispositivos que admita en todos los buses PCI de la máquina primero y, a continuación, llamar HalGetBusData(ByOffset) de nuevo para solicitar más información de configuración sobre los dispositivos de interés. Este controlador podría codificar un bucle que llama HalGetBusData(ByOffset) a con una entrada Buffer suficiente Length solo para contener suficiente del PCI_COMMON_CONFIG para determinar el VendorID y DeviceID de cada dispositivo PCI. Después de encontrar los Slot números de los dispositivos PCI prometedores, el controlador llamaría a HalGetBusData o HalGetBusDataByOffset una o varias veces con espacio de búfer adicional para obtener la información necesaria para configurar sus dispositivos.