Fungsi VideoPortGetBusData (video.h)

Artikel
08/07/2023

Fungsi VideoPortGetBusData mengembalikan informasi konfigurasi khusus jenis bus.

Sintaks

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortGetBusData(
        PVOID         HwDeviceExtension,
        BUS_DATA_TYPE BusDataType,
        ULONG         SlotNumber,
  [out] PVOID         Buffer,
        ULONG         Offset,
        ULONG         Length
);

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

BusDataType

Menentukan jenis data konfigurasi bus yang akan dikembalikan. Nilai parameter ini dapat berupa Cmos, EisaConfiguration, atau PCIConfiguration. Namun, jenis konfigurasi bus tambahan mungkin didukung di masa mendatang. Batas atas pada jenis yang didukung selalu MaximumBusDataType.

SlotNumber

Menentukan lokasi perangkat di bus untuk Cmos BusDataType; nol untuk semua jenis bus lainnya.

[out] Buffer

Arahkan ke buffer tempat VideoPortGetBusData mengembalikan informasi konfigurasi. Konten buffer bergantung pada BusDataType, sebagai berikut:

Jika Cmos ditentukan, buffer berisi konten cmos (nomor bus sama dengan nol) atau lokasi ECMOS (nomor bus sama dengan satu), dimulai dengan lokasi yang ditentukan untuk SlotNumber. Fungsi HwVidFindAdapter driver miniport dapat menentukan jumlah bus dari anggota SystemIoBusNumber dari struktur input VIDEO_PORT_CONFIG_INFO .
Jika EisaConfiguration ditentukan, buffer berisi struktur CM_EISA_SLOT_INFORMATION , diikuti dengan nol atau lebih struktur CM_EISA_FUNCTION_INFORMATION untuk slot yang ditentukan.
Jika PCIConfiguration ditentukan, buffer berisi informasi PCI_COMMON_CONFIG untuk slot yang ditentukan.

Offset

Menentukan offset, dalam byte, ke dalam ruang konfigurasi PCI yang harus diambil Jika BusDataType adalah PCIConfiguration; jika tidak, nol. Lihat Keterangan untuk informasi selengkapnya.

Length

Menentukan panjang, dalam byte, buffer.

Nilai kembali

VideoPortGetBusData mengembalikan jumlah byte informasi konfigurasi yang telah ditulisnya dalam Buffer. Jika BusDataType yang diberikan tidak valid untuk platform saat ini, fungsi ini umumnya mengembalikan nol.

Menampilkan kode	Deskripsi
0	Bus PCI tidak ada.
2	Bus PCI ada, tetapi Buffer berisi nilai yang PCI_INVALID_VENDOR_ID di anggota PCI_COMMON_CONFIG VendorId.

Keterangan

Untuk mendapatkan hanya bagian dari informasi konfigurasi, driver miniport harus mengatur Offset ke offset byte dari informasi yang diperlukan, dan mengatur Panjang ke jumlah byte informasi yang diperlukan. Misalnya, jika hanya register perintah yang diperlukan, atur Offset ke offset register ini, dan atur Panjang ke sizeof (USHORT).

Driver harus memanggil VideoPortGetAccessRanges daripada VideoPortGetBusData untuk mengambil sumber daya perangkat kerasnya.

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