struktur PCI_SLOT_NUMBER (wdm.h)

Artikel
02/27/2024

Struktur PCI_SLOT_NUMBER sudah usang. Ini mendefinisikan format parameter Slot ke rutinitas HalXxxBusData usang ketika dipanggil dengan nilai BusDataTypePCIConfiguration.

Sintaks

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;

Anggota

u

u.bits

Menentukan perangkat tertentu pada adaptor multifungsi pada slot tertentu yang sedang dikonfigurasi. DeviceNumber menunjukkan nomor slot logis untuk adaptor; FunctionNumber menunjukkan perangkat tertentu pada adaptor tersebut.

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Menentukan nomor slot logis perangkat yang sedang dikonfigurasi.

Keterangan

Driver perangkat PCI dapat memanggil HalGetBusData atau HalGetBusDataByOffset lebih dari sekali untuk nomor slot yang sama untuk mendapatkan informasi konfigurasi untuk perangkat mereka.

Misalnya, driver mungkin mencari perangkat yang didukungnya pada semua bus PCI di komputer terlebih dahulu, lalu memanggil HalGetBusData(ByOffset) lagi untuk meminta informasi konfigurasi lebih lanjut tentang perangkat yang menarik. Driver seperti itu dapat membuat kode perulangan yang memanggil HalGetBusData(ByOffset) dengan input Buffer yang cukup Length hanya untuk memuat cukup PCI_COMMON_CONFIG untuk menentukan VendorID dan DeviceID dari setiap perangkat PCI. Setelah menemukan Slot nomor untuk perangkat PCI yang menjanjikan, driver akan memanggil HalGetBusData atau HalGetBusDataByOffset satu atau beberapa kali dengan ruang buffer tambahan untuk mendapatkan informasi yang diperlukan untuk mengonfigurasi perangkatnya.