estrutura PCI_SLOT_NUMBER (wdm.h)

Artigo
03/01/2024

A estrutura PCI_SLOT_NUMBER está obsoleta. Ele define o formato do parâmetro Slot para as rotinas obsoletas de HalXxxBusData quando são chamadas com o valor de BusDataTypePCIConfiguration.

Sintaxe

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;

Membros

u

u.bits

Especifica o dispositivo específico em um adaptador multifuncional no slot especificado que está sendo configurado. O DeviceNumber indica o número do slot lógico para o adaptador; o FunctionNumber indica o dispositivo específico nesse adaptador.

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Especifica o número do slot lógico do dispositivo que está sendo configurado.

Comentários

Os drivers de dispositivos PCI podem chamar HalGetBusData ou HalGetBusDataByOffset mais de uma vez para que o mesmo número de slot obtenha as informações de configuração de seus dispositivos.

Por exemplo, um driver pode pesquisar dispositivos aos quais dá suporte em todos os barramentos PCI no computador primeiro e, em seguida, chamar HalGetBusData(ByOffset) novamente para solicitar mais informações de configuração sobre dispositivos de interesse. Esse driver poderia codificar um loop que chama HalGetBusData(ByOffset) com uma entrada Buffer de suficiente Length apenas para conter o suficiente do PCI_COMMON_CONFIG para determinar o VendorID e DeviceID de cada dispositivo PCI. Depois de encontrar os Slot números de qualquer dispositivo PCI promissor, o driver chamaria HalGetBusData ou HalGetBusDataByOffset uma ou mais vezes com espaço de buffer adicional para obter as informações necessárias para configurar seus dispositivos.