Fungsi VideoPortSetBusData (video.h)
Fungsi VideoPortSetBusData mengatur data konfigurasi bus untuk adaptor pada bus I/O yang dapat dikonfigurasi secara dinamis dengan antarmuka standar yang diterbitkan.
Sintaks
VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
PVOID HwDeviceExtension,
BUS_DATA_TYPE BusDataType,
ULONG SlotNumber,
[in] PVOID Buffer,
ULONG Offset,
ULONG Length
);
Parameter
HwDeviceExtension
Arahkan ke ekstensi perangkat driver miniport.
BusDataType
Menentukan jenis data bus yang akan diatur. Saat ini, nilainya bisa menjadi salah satu Cmos, EisaConfiguration, atau PCIConfiguration. Namun, jenis tambahan bus standar yang dapat dikonfigurasi secara dinamis mungkin didukung di masa mendatang. Batas atas pada jenis bus yang didukung selalu MaximumBusDataType.
SlotNumber
Untuk nilai BusDataTypecmos, menentukan lokasi perangkat di bus. Parameter ini harus nol untuk semua jenis bus lainnya.
[in] Buffer
Pointer ke area penyimpanan yang disediakan penelepon dengan informasi konfigurasi khusus untuk BusDataType.
Ketika PCIConfiguration ditentukan, buffer berisi beberapa atau semua informasi PCI_COMMON_CONFIG untuk SlotNumber yang diberikan. Offset dan Panjang yang ditentukan menentukan berapa banyak informasi yang disediakan.
Offset
Menentukan offset byte dalam struktur PCI_COMMON_CONFIG di mana nilai konfigurasi yang disediakan pemanggil dimulai. Driver miniport dapat menggunakan PCI_COMMON_HDR_LENGTH untuk menentukan offset area khusus perangkat di PCI_COMMON_CONFIG.
Length
Menentukan jumlah byte dalam Buffer.
Nilai kembali
VideoPortSetBusData mengembalikan jumlah byte data yang berhasil diatur untuk SlotNumber yang diberikan. Jika BusDataType yang diberikan tidak valid untuk platform saat ini atau jika informasi yang disediakan tidak valid, VideoPortSetBusData mengembalikan nol.
Keterangan
Driver miniport adaptor pada bus PCI jarang memanggil VideoPortSetBusData, kecuali keadaan yang tidak biasa atau sifat adaptor video driver tertentu memerlukan panggilan seperti itu.
Misalnya, driver miniport mungkin memanggil VideoPortSetBusData untuk menghapus sedikit dalam daftar status PCI jika adaptornya memberi sinyal pembatalan target selama inisialisasi. Jika adaptor video PCI harus dikonfigurasi dengan data khusus perangkat, drivernya juga memanggil fungsi ini. Dalam kedua kasus, driver tersebut kemudian kemungkinan akan memanggil VideoPortGetAccessRanges dengan penunjuk RequestedResources ke array deskriptor sumber daya yang disediakan driver.
VideoPortSetBusData tidak dapat dipanggil dari fungsi HwVidInterrupt atau HwVidTimer driver miniport, atau dari VideoPortQueueDpc, atau dari panggilan balik ke VideoPortSynchronizeExecution.
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 |