Fungsi VideoPortGetBusData (video.h)
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 |