struktur VIDEO_HW_INITIALIZATION_DATA (video.h)
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 .
Persyaratan
Persyaratan | Nilai |
---|---|
Header | video.h (sertakan Video.h) |