struttura KBUGCHECK_ADD_PAGES (wdm.h)
La struttura KBUGCHECK_ADD_PAGES descrive una o più pagine di dati forniti dal driver da scrivere da una funzione di callback KBUGCHECK_REASON_CALLBACK_ROUTINE nel file di dump dell'arresto anomalo del sistema.
Sintassi
typedef struct _KBUGCHECK_ADD_PAGES {
PVOID Context;
ULONG Flags;
ULONG BugCheckCode;
ULONG_PTR Address;
ULONG_PTR Count;
} KBUGCHECK_ADD_PAGES, *PKBUGCHECK_ADD_PAGES;
Members
Context
Contiene dati di contesto privato per l'uso esclusivo della routine di callback. La routine di callback può impostare questo membro su qualsiasi valore. In genere, se la routine di callback deve essere chiamata più volte, la routine imposta questo membro in modo che punti a un buffer fornito dal driver durante la chiamata iniziale. Durante le chiamate successive, la routine di callback può leggere il contenuto precedente di questo buffer e aggiornarne il contenuto. Prima della chiamata iniziale alla routine di callback, Context è NULL.
Flags
Contiene flag che descrivono la richiesta di aggiunta pagina. La routine di callback deve impostare il valore di questo membro. Impostare questo membro sull'OR bit per bit di uno o più dei bit di flag seguenti:
KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS
Indica che il membro Address contiene un indirizzo virtuale.
KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS
Indica che il membro Address contiene un indirizzo fisico.
KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST
Indica che la routine di callback richiede di essere chiamata di nuovo in modo che possa aggiungere altre pagine.
La routine di callback deve impostare il flag KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS o il flag di KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS, ma non entrambi. Nella voce della routine di callback, Flags viene inizializzato su zero.
BugCheckCode
Contiene un codice di controllo di bug, che specifica il motivo del controllo dei bug. La routine di callback può utilizzare queste informazioni per decidere se aggiungere pagine al file di dump di arresto anomalo del sistema. Per un elenco completo dei codici di controllo dei bug, vedere il file di intestazione Bugcodes.h incluso in WDK.
Address
Specifica l'indirizzo fisico o virtuale della pagina o delle pagine che le richieste di routine di callback vengono aggiunte al file di dump di arresto anomalo del sistema.
Count
Specifica il numero di pagine contigue da aggiungere al file di dump di arresto anomalo del sistema, a partire dall'indirizzo virtuale o fisico specificato dal membro Address . Se Count> 1 e Address sono un indirizzo virtuale, le pagine sono contigue nello spazio di memoria virtuale. Se Count> 1 e Address sono un indirizzo fisico, le pagine sono contigue nello spazio di memoria fisico. La routine di callback può impostare questo membro su zero per indicare che non è necessario aggiungere pagine al file di dump di arresto anomalo del sistema.
Commenti
In una chiamata alla routine di callback KbCallbackAddPages , il sistema operativo imposta il parametro Reason su KbCallbackAddPages e imposta il parametro ReasonSpecificData in modo che punti a una struttura KBUGCHECK_ADD_PAGES .
Per altre informazioni sull'uso di questa struttura, vedere Scrittura di una routine di callback di controllo bug e KBUGCHECK_REASON_CALLBACK_ROUTINE funzione di callback.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in Windows Server 2008 e versioni successive di Windows. |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |