Fungsi VideoPortInitialize (video.h)

Artikel
03/01/2024

Fungsi VideoPortInitialize melakukan bagian dari inisialisasi driver miniport, mengalokasikan sumber daya sistem untuk driver miniport.

Sintaks

VIDEOPORT_API ULONG VideoPortInitialize(
  PVOID                         Argument1,
  PVOID                         Argument2,
  PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
  PVOID                         HwContext
);

Parameter

Argument1

Pointer dengan sistem operasi yang disebut DriverEntry dari Driver Video Miniport.

Argument2

Pointer kedua dengan sistem operasi yang disebut DriverEntry.

HwInitializationData

Arahkan ke struktur VIDEO_HW_INITIALIZATION_DATA pada tumpukan. DriverEntry driver miniport rutin nol-inisialisasi struktur ini dan kemudian mengisinya dengan informasi konfigurasi khusus driver yang menjelaskan adaptor video yang dapat didukung driver miniport.

HwContext

Harus NULL.

Nilai kembali

VideoPortInitialize mengembalikan status akhir operasi inisialisasi.

Keterangan

Setiap driver miniport video harus memanggil VideoPortInitialize dari fungsi DriverEntry-nya . DriverEntry dapat memanggil VideoPortInitialize hanya setelah pertama kali diinisialisasi nol lalu menyiapkan struktur VIDEO_HW_INITIALIZATION_DATA . VideoPortInitialize hanya dapat dipanggil dari fungsi DriverEntry driver miniport.

Fungsi VideoPortInitialize :

Memeriksa validitas spesifikasi VIDEO_HW_INITIALIZATION_DATA driver miniport.
Mengalokasikan memori untuk dan menginisialisasi struktur VIDEO_PORT_CONFIG_INFO .
Mengisi informasi konfigurasi adaptor sebanyak mungkin di VIDEO_PORT_CONFIG_INFO.
Mengisi beberapa anggota publik objek perangkat yang dibuat oleh sistem untuk mewakili adaptor grafis. Driver port video mengelola objek perangkat, oleh karena itu, driver miniport tidak perlu khawatir dengan detail objek perangkat.
Mengalokasikan memori untuk, dan menginisialisasi nol ekstensi perangkat, objek perangkat. Ekstensi perangkat adalah area penyimpanan global utama dan satu-satunya driver miniport untuk informasi status khusus adaptor. Driver miniport menentukan ukuran ekstensi perangkat di anggota HwDeviceExtensionSize dari VIDEO_HW_INITIALIZATION_DATA. Driver port video meneruskan ekstensi perangkat ini ke sebagian besar fungsi driver miniport yang dipanggilnya.
Mengumpulkan dan menyimpan informasi yang bersangkutan dalam ekstensi perangkat.

DriverEntry driver miniport rutin menyebarluaskan nilai yang dikembalikan oleh VideoPortInitialize kembali ke pemanggilnya. Driver Miniport tidak boleh menggunakan nilai pengembalian ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL