Funzione IoGetConfigurationInformation (ntifs.h)
La routine IoGetConfigurationInformation restituisce un puntatore alla struttura di informazioni di configurazione globale del gestore di I/O, che contiene i valori correnti per il numero di dischi fisici, floppy, CD-ROM, nastro, HBA SCSI, seriale e paralleli in cui i dispositivi dispositivo sono creati per rappresentarli dai driver mentre vengono caricati.
Sintassi
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
Valore restituito
IoGetConfigurationInformation restituisce un puntatore a una struttura CONFIGURATION_INFORMATION .
Commenti
Alcuni tipi di driver di dispositivo possono usare i valori della struttura delle informazioni di configurazione per costruire nomi di oggetti dispositivo con suffissi di cifre appropriati quando ogni driver crea gli oggetti dispositivo. Si noti che il suffisso cifra per i nomi degli oggetti dispositivo è un conteggio in base zero, mentre i conteggi mantenuti nella struttura delle informazioni di configurazione rappresentano il numero di oggetti dispositivo di un particolare tipo già creato. Ovvero, i conteggi delle informazioni di configurazione sono basati su un solo.
Qualsiasi driver che chiama IoGetConfigurationInformation deve incrementare il conteggio per il tipo di dispositivo in questa struttura quando crea un oggetto dispositivo per rappresentare un dispositivo fisico.
Il driver di porta SCSI fornito dal sistema fornisce il numero di HBA SCSI presenti nel computer. I driver di classe SCSI possono leggere questo valore per determinare il numero di driver miniport specifici di HBA che possono controllare un bus SCSI con un dispositivo collegato del tipo di driver di classe.
La struttura delle informazioni di configurazione contiene anche un valore che indica se un driver già caricato ha richiesto uno degli intervalli di indirizzi di I/O del disco "AT".
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 |
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |