struktur VIDEO_HW_INITIALIZATION_DATA (video.h)

Artikel
08/08/2023

Struktur VIDEO_HW_INITIALIZATION_DATA menentukan titik masuk dan persyaratan penyimpanan untuk driver miniport. Struktur ini dibuat pada tumpukan dan diinisialisasi oleh fungsi DriverEntry driver miniport.

Sintaks

typedef struct _VIDEO_HW_INITIALIZATION_DATA {
  ULONG                          HwInitDataSize;
  INTERFACE_TYPE                 AdapterInterfaceType;
  PVIDEO_HW_FIND_ADAPTER         HwFindAdapter;
  PVIDEO_HW_INITIALIZE           HwInitialize;
  PVIDEO_HW_INTERRUPT            HwInterrupt;
  PVIDEO_HW_START_IO             HwStartIO;
  ULONG                          HwDeviceExtensionSize;
  ULONG                          StartingDeviceNumber;
  PVIDEO_HW_RESET_HW             HwResetHw;
  PVIDEO_HW_TIMER                HwTimer;
  PVIDEO_HW_START_DMA            HwStartDma;
  PVIDEO_HW_POWER_SET            HwSetPowerState;
  PVIDEO_HW_POWER_GET            HwGetPowerState;
  PVIDEO_HW_GET_CHILD_DESCRIPTOR HwGetVideoChildDescriptor;
  PVIDEO_HW_QUERY_INTERFACE      HwQueryInterface;
  ULONG                          HwChildDeviceExtensionSize;
  PVIDEO_ACCESS_RANGE            HwLegacyResourceList;
  ULONG                          HwLegacyResourceCount;
  PVIDEO_HW_LEGACYRESOURCES      HwGetLegacyResources;
  BOOLEAN                        AllowEarlyEnumeration;
  ULONG                          Reserved;
} VIDEO_HW_INITIALIZATION_DATA, *PVIDEO_HW_INITIALIZATION_DATA;

Anggota

HwInitDataSize

Adalah ukuran dalam byte struktur ini. Akibatnya, ini menunjukkan versi VIDEO_HW_INITIALIZATION_DATA yang digunakan.

AdapterInterfaceType

Saat ini diabaikan oleh port video dan harus tetap diinisialisasi nol.

HwFindAdapter

Penunjuk ke fungsi HwVidFindAdapter driver miniport, yang diperlukan untuk semua driver miniport.

HwInitialize

Penunjuk ke fungsi HwVidInitialize driver miniport, yang diperlukan untuk semua driver miniport.

HwInterrupt

Penunjuk ke fungsi HwVidInterrupt driver miniport, yang diperlukan hanya jika adaptor driver miniport menghasilkan gangguan. Jika tidak, pointer ini harus NULL.

HwStartIO

Penunjuk ke fungsi HwVidStartIO driver miniport, yang diperlukan untuk semua driver miniport.

HwDeviceExtensionSize

Menentukan ukuran dalam byte penyimpanan yang diperlukan driver miniport untuk ekstensi perangkat pribadi khusus adaptornya. Driver miniport menggunakan penyimpanan ini untuk menyimpan informasi per adaptor yang ditentukan driver, seperti rentang alamat logis yang dipetakan untuk register adaptor dan informasi konteks apa pun yang dikelola driver tentang operasi I/O-nya.

Pointer ke ekstensi perangkat diteruskan dalam setiap panggilan yang dilakukan ke fungsi standar driver miniport kecuali DriverEntry, HwVidSynchronizeExecutionCallback, dan fungsi SvgaHwIoPortXxx apa pun. Driver port video mengalokasikan memori untuk ekstensi perangkat dan menginisialisasinya dengan nol sebelum diteruskan ke fungsi HwVidFindAdapter driver miniport.

StartingDeviceNumber

Harus diatur ke nol.

HwResetHw

Penunjuk ke fungsi HwVidResetHw driver miniport, yang diperlukan untuk setiap driver miniport adaptor yang tidak direset sepenuhnya pada reboot lunak mesin. Driver adaptor SVGA yang sepenuhnya diatur ulang ke mode karakter standar VGA pada tanda terima perintah INT10, jenis MODE3 biasanya mengatur ini ke NULL.

HwTimer

Penunjuk ke fungsi HwVidTimer driver miniport, yang bersifat opsional. Penunjuk ini bisa NULL.

HwStartDma

Dicadangkan untuk penggunaan sistem.

HwSetPowerState

Penunjuk ke fungsi HwVidSetPowerState driver miniport, yang diperlukan untuk semua driver miniport.

HwGetPowerState

Penunjuk ke fungsi HwVidGetPowerState driver miniport, yang diperlukan untuk semua driver miniport.

HwGetVideoChildDescriptor

Penunjuk ke fungsi HwVidGetVideoChildDescriptor driver miniport, yang diperlukan untuk semua driver miniport.

HwQueryInterface

Penunjuk ke fungsi HwVidQueryInterface driver miniport. Ini dapat diimplementasikan secara opsional dalam driver miniport yang mendukung antarmuka pemrograman eksternal untuk komunikasi antar-perangkat, seperti dukungan I2C (atau I²C) untuk dekode MPEG. Jika tidak, anggota ini harus diatur ke NULL.

HwChildDeviceExtensionSize

Adalah ukuran dalam byte ekstensi perangkat yang terkait dengan perangkat output tampilan. Driver miniport harus mengisi anggota ini hanya jika driver miniport perlu mengelola data konfigurasi monitor secara terpisah dari konfigurasi papan adaptor.

HwLegacyResourceList

Penunjuk ke array struktur VIDEO_ACCESS_RANGE . Setiap struktur menjelaskan port I/O perangkat atau rentang memori untuk adaptor video yang tidak tercantum dalam ruang konfigurasi PCI.

HwLegacyResourceCount

Adalah jumlah elemen dalam array tempat HwLegacyResourceList menunjuk.

HwGetLegacyResources

Penunjuk ke fungsi HwVidLegacyResources driver miniport, yang memungkinkan driver menentukan sumber daya warisannya berdasarkan ID perangkat dan vendornya.

AllowEarlyEnumeration

Memungkinkan driver miniport menghitung perangkat turunannya sebelum adaptor dimulai; artinya, driver port video dapat memanggil HwVidGetVideoChildDescriptor sebelum HwVidFindAdapter ketika anggota ini diatur ke TRUE.

Reserved

Dicadangkan untuk penggunaan sistem.

Keterangan

Fungsi DriverEntry driver miniport harus menginisialisasi struktur ini dengan nol sebelum menetapkan nilai yang relevan dalam anggota mana pun.

Driver port video akan mengabaikan anggota HwLegacyResourceCount dan HwLegacyResourceList ketika HwGetLegacyResources diinisialisasi dengan pointer ke implementasi HwVidLegacyResources .