IRP_MN_READ_CONFIG

Articolo
06/15/2023

I conducenti degli autobus con spazio di configurazione devono gestire questa richiesta per i dispositivi figlio (PDO figlio). I driver di filtro e di funzione non gestiscono questa richiesta.

Valore

0x0F

Codice principale

IRP_MJ_PNP

Data di invio

Un driver o un altro componente di sistema invia questo IRP per leggere lo spazio di configurazione del bus padre di un dispositivo.

Un driver o un altro componente di sistema invia questo IRP al DISPATCH_LEVEL IRQL < in un contesto di thread arbitrario.

Parametri di input

Il membro Parameters.ReadWriteConfig della struttura IO_STACK_LOCATION è una struttura contenente le informazioni seguenti:

ULONG WhichSpace;
PVOID Buffer;
ULONG Offset;
ULONG Length

I membri della struttura possono essere interpretati in modo diverso da driver di bus diversi, ma i membri vengono in genere definiti come segue:

WhichSpace
Specifica l'area di memoria a cui accedere. Questo parametro può accettare i valori seguenti:

Valore	Bus	Significato
PCI_WHICHSPACE_CONFIG	PCI	Spazio di configurazione PCI.
PCI_WHICHSPACE_ROM	PCI	Memoria di sola lettura.
PCCARD_COMMON_MEMORY PCCARD_COMMON_MEMORY_INDIRECT	PCMCIA	Memoria PCCARD principale.
PCCARD_ATTRIBUTE_MEMORY PCCARD_ATTRIBUTE_MEMORY_INDIRECT	PCMCIA	Spazio dell'attributo PCMCIA (configurazione).
PCCARD_PCI_CONFIGURATION_SPACE	PCMCIA	Spazio di configurazione PCI.

I valori PCI_XXX sono definiti in Wdm.h. I valori PCCARD_XXX sono definiti in Ntddpcm.h.

Buffer
Punta a un buffer in cui restituire le informazioni richieste. Il componente che invia l'IRP alloca questa struttura dalla memoria di paging. Il formato del buffer è specifico del bus.

Compensare
Specifica un offset nello spazio di configurazione.

Lunghezza
Specifica il numero di byte da leggere.

Parametri di output

In caso di esito positivo, un driver del bus riempie il buffer in Parameters.ReadWriteConfig.Buffer con i dati richiesti.

Blocco dello stato I/O

Un driver del bus imposta Irp-IoStatus.Status> su STATUS_SUCCESS o su uno stato di errore appropriato, ad esempio STATUS_INVALID_PARAMETER_n, STATUS_NO_SUCH_DEVICE o STATUS_DEVICE_NOT_READY.

In caso di esito positivo, un driver del bus imposta Irp-IoStatus.Information> sul numero di byte restituiti.

Se un driver del bus non è in grado di completare questa richiesta immediatamente, può contrassegnare l'IRP in sospeso, restituire STATUS_PENDING e completare l'IRP in un secondo momento.

Operazione

Un driver del bus gestisce questo IRP per i dispositivi figlio (PDO figlio).

I driver di funzione e filtro non gestiscono questo IRP; passano al driver inferiore successivo senza modifiche a Irp-IoStatus>. Stato e non impostano una routine IoCompletion.

Un driver del bus che gestisce questa richiesta deve controllare il parametro WhichSpace per assicurarsi che contenga un valore supportato dal driver.

Vedere Plug and Play per le regole generali per la gestione di Plug and Play irP secondari.

Invio di questo IRP

In genere, un driver di funzione invia questo IRP al driver principale nello stack di dispositivi a cui è collegato e l'IRP viene gestito dal driver del bus padre.

Per informazioni sull'invio di provider di integrazione, vedere Gestione dei runtime di integrazione. I passaggi seguenti si applicano in modo specifico a questo IRP:

Allocare un buffer da un pool di paging e inizializzarlo in zeri.
Impostare i valori nella successiva posizione dello stack di I/O di IRP: impostare MajorFunction su IRP_MJ_PNP, impostare MinorFunction su IRP_MN_READ_CONFIG e impostare i valori appropriati in Parameters.ReadWriteConfig.
Inizializzare IoStatus.Status per STATUS_NOT_SUPPORTED.
Deallocare l'IRP e il buffer quando non sono più necessari.

I driver devono inviare questo IRP dal DISPATCH_LEVEL IRQL < .

Un driver può accedere allo spazio di configurazione di un bus in DISPATCH_LEVEL tramite una routine dell'interfaccia del bus, se il driver del bus padre supporta tale interfaccia. Per ottenere un'interfaccia del bus, un driver invia una richiesta di IRP_MN_QUERY_INTERFACE allo stack di dispositivi in cui è collegato il driver. Il driver chiama quindi la routine appropriata restituita nell'interfaccia .

Ad esempio, per leggere lo spazio di configurazione da DISPATCH_LEVEL, un driver può chiamare IRP_MN_QUERY_INTERFACE durante l'inizializzazione del driver per ottenere l'interfaccia BUS_INTERFACE_STANDARD dal driver del bus padre. Il driver invia la query IRP dal PASSIVE_LEVEL IRQL. Successivamente, dal codice in IRQL DISPATCH_LEVEL, il driver chiama la routine appropriata restituita nell'interfaccia, ad esempio la routine Interface.GetBusData .

Requisiti

Intestazione

Wdm.h (include Wdm.h, Ntddk.h o Ntifs.h)

Vedi anche

IRP_MN_QUERY_INTERFACE

IRP_MN_WRITE_CONFIG

Share via