struttura KBUGCHECK_ADD_PAGES (wdm.h)

  • Articolo

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)

Vedi anche

Scrittura di una routine di callback controllo bug.