Fungsi VideoPortGetAccessRanges (video.h)

Artikel
08/07/2023

Usang. Fungsi VideoPortGetAccessRanges mengambil informasi konfigurasi relatif bus dan, jika memungkinkan, mengklaim sumber daya perangkat keras ini di registri untuk pemanggil.

Sintaksis

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetAccessRanges(
  PVOID                   HwDeviceExtension,
  ULONG                   NumRequestedResources,
  PIO_RESOURCE_DESCRIPTOR RequestedResources,
  ULONG                   NumAccessRanges,
  PVIDEO_ACCESS_RANGE     AccessRanges,
  PVOID                   VendorId,
  PVOID                   DeviceId,
  PULONG                  Slot
);

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

NumRequestedResources

Menentukan jumlah elemen dalam array RequestedResources.

RequestedResources

[dalam, opsional] Array elemen jenis IO_RESOURCE_DESCRIPTOR. Setiap deskriptor menentukan satu sumber daya perangkat keras yang dibutuhkan driver miniport, lebih disukai, atau dapat digunakan sebagai alternatif untuk yang ditentukan dalam elemen array lain. Untuk informasi terperinci tentang struktur ini, lihat deskripsi IoAssignResources.

NumAccessRanges

Menentukan jumlah elemen dalam array AccessRanges .

AccessRanges

[out] Pointer ke area pada tumpukan atau ke struktur statis di driver miniport tempat VideoPortGetAccessRanges mengembalikan array elemen VIDEO_ACCESS_RANGE yang diisi dengan rentang memori perangkat relatif bus untuk adaptor.

VendorId

Harus diatur ke NULL.

DeviceId

Harus diatur ke NULL.

Slot

Penunjuk ke lokasi memori di mana driver port video menyimpan nomor slot untuk perangkat, atau NULL.

Untuk perangkat Plug and Play, jika ini adalah penunjuk yang valid, driver port video menyimpan nomor slot di lokasi memori yang ditentukan oleh penunjuk. Jika nilai NULL diteruskan dalam panggilan, driver port video tidak menyimpan nilai di lokasi.

Mengembalikan nilai

VideoPortGetAccessRanges mengembalikan NO_ERROR jika berhasil mengisi informasi AccessRanges atau informasi konfigurasi yang dikembalikan di RequestedResources.

Komentar

Setiap driver miniport video harus menggunakan rentang akses yang dikembalikan oleh VideoPortGetAccessRanges, atau harus memanggil VideoPortVerifyAccessRanges sebelum mencoba mengakses adaptor video selama proses inisialisasi driver (dan sistem).

VideoPortGetAccessRanges hanya dapat dipanggil dari fungsi HwVidFindAdapter driver miniport.

Untuk sebagian besar driver miniport, VideoPortGetAccessRanges dapat mengambil, memverifikasi, dan mengklaim rentang akses relatif bus dan setiap gangguan dan/atau saluran/port DMA yang digunakan oleh adaptor video tertentu, sementara VideoPortVerifyAccessRanges hanya dapat memverifikasi dan mengklaim sumber daya miniport yang ditentukan driver. Artinya, untuk semua informasi konfigurasi yang dikembalikannya, VideoPortGetAccessRanges mengklaim sumber daya perangkat keras yang sesuai dalam registri untuk pemanggil. Driver miniport tidak perlu memanggil VideoPortVerifyAccessRanges dengan informasi konfigurasi relatif bus yang dikembalikan, kecuali driver miniport mencoba memodifikasi salah satu nilai yang dikembalikan.

Setiap panggilan yang berhasil untuk VideoPortGetAccessRanges atau VideoPortVerifyAccessRanges untuk adaptor tertentu menimpa klaim sebelumnya driver miniport pada sumber daya perangkat keras di registri.

Setelah panggilan berhasil ke VideoPortGetAccessRanges, driver miniport harus memetakan rentang relatif bus yang dikembalikan ke rentang logis denganVideoPortGetDeviceBase sebelum memanggil fungsi VideoPortRead/Write****Xxx yang sesuai untuk berkomunikasi dengan adaptor.

Umumnya, driver miniport perangkat PCI harus memiliki panggilan fungsi HwVidFindAdapter VideoPortGetAccessRanges, daripada mencoba memanipulasi informasi PCI_COMMON_CONFIG khusus nondevice yang dikembalikan oleh panggilan ke VideoPortGetBusData. Driver miniport ini biasanya dapat memanggil VideoPortGetAccessRanges dengan pointer NULLRequestedResources. Driver port video kemudian menggunakan ruang konfigurasi bus PCI untuk menentukan sumber daya untuk adaptor video. Driver miniport dapat memanggil VideoPortGetAccessRanges, menggunakan serangkaian spesifikasi RequestedResources yang disediakan driver, jika panggilan aslinya gagal mengembalikan data konfigurasi yang valid untuk adaptor.

Perhatikan bahwa driver miniport adaptor pada jenis bus I/O lainnya juga dapat memanggil VideoPortGetAccessRanges. Driver ini harus memanggil VideoPortGetAccessRanges menggunakan RequestedResources pointer ke array deskriptor sumber daya I/O yang disediakan driver.

Jika fungsi HwVidFindAdapter mengklaim rentang akses relatif bus dan mungkin sumber daya perangkat keras lainnya untuk adaptor, tetapi kemudian menentukan bahwa ia tidak mendukung adaptor, maka driver miniport harus melepaskan klaimnya pada sumber daya perangkat keras di registri dengan memanggil VideoPortGetAccessRanges atau VideoPortVerifyAccessRanges dengan parameter NumAccessRanges diatur ke nol.