Fungsi IoGetConfigurationInformation (ntifs.h)

Rutinitas IoGetConfigurationInformation mengembalikan penunjuk ke struktur informasi konfigurasi global manajer I/O, yang berisi nilai saat ini untuk berapa banyak disk fisik, floppy, CD-ROM, pita, SCSI HBA, serial, dan perangkat paralel yang memiliki objek perangkat yang dibuat untuk mewakilinya oleh driver saat dimuat.

Sintaks

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

Mengembalikan nilai

IoGetConfigurationInformation mengembalikan penunjuk ke struktur CONFIGURATION_INFORMATION .

Keterangan

Jenis driver perangkat tertentu dapat menggunakan nilai struktur informasi konfigurasi untuk membuat nama objek perangkat dengan akhiran digit yang sesuai saat setiap driver membuat objek perangkatnya. Perhatikan bahwa akhiran digit untuk nama objek perangkat adalah jumlah berbasis nol, sementara jumlah yang dipertahankan dalam struktur informasi konfigurasi mewakili jumlah objek perangkat dari jenis tertentu yang sudah dibuat. Artinya, jumlah informasi konfigurasi berbasis satu.

Setiap driver yang memanggil IoGetConfigurationInformation harus menambah jumlah untuk jenis perangkatnya dalam struktur ini ketika membuat objek perangkat untuk mewakili perangkat fisik.

Driver port SCSI yang disediakan sistem memasok jumlah SCSI HBA yang ada di komputer. Driver kelas SCSI dapat membaca nilai ini untuk menentukan berapa banyak driver miniport khusus HBA yang mungkin mengontrol bus SCSI dengan perangkat yang terpasang dari jenis driver kelas.

Struktur informasi konfigurasi juga berisi nilai yang menunjukkan apakah driver yang sudah dimuat telah mengklaim salah satu rentang alamat I/O disk "AT".

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000
Target Platform Universal
Header ntifs.h (termasuk Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Lihat juga

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage