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)

Vedi anche

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage