Funzione di callback pHalSetSystemInformation (ntddk.h)

Articolo
02/07/2025

Registrare il driver MCA con HAL.

Sintassi

pHalSetSystemInformation Phalsetsysteminformation;

NTSTATUS Phalsetsysteminformation(
  [in]  HAL_SET_INFORMATION_CLASS InformationClass,
  [in]  ULONG BufferSize,
  [out] PVOID Buffer
)
{...}

Parametri

[in] InformationClass

HalMcaRegisterDriver per registrare le routine di callback del driver MCA con HAL. Esistono due routine di callback: ExceptionCallback e DpcCallback. La routine ExceptionCallback viene chiamata durante l'elaborazione degli errori non riavviabile del gestore dell'eccezione del controllo computer prima di generare un controllo dei bug per il sistema. La routine DpcCallback viene chiamata quando l'errore MCA è riavviabile. Per i sistemi Itanium, specificare HalCmcRegisterDriver per registrare la routine DpcCallback dell'errore cpu corretto di un driver e HalCpeRegisterDriver per registrare l'errore di piattaforma corretto di un driver DpcCallback.

[in] BufferSize

Dimensione, in byte, del buffer fornito dal chiamante.

[out] Buffer

Puntatore a un buffer fornito dal chiamante di tipo MCA_DRIVER_INFO, definito come segue.

typedef struct _MCA_DRIVER_INFO {
  PDRIVER_EXCPTN_CALLBACK  ExceptionCallback; // NULL for Itanium corrected error registration
  PKDEFERRED_ROUTINE  DpcCallback;
  PVOID  DeviceContext;
} MCA_DRIVER_INFO, *PMCA_DRIVER_INFO;

Questa struttura contiene i membri seguenti:

ExceptionCallback

Routine fornita dal driver da chiamare quando si verifica l'eccezione mce (Machine Check Exception) per gli errori non corretti. Un driver in modo esplicito non può usare alcun servizio kernel o routine di blocco di selezione. Il gestore è limitato agli stessi vincoli di un driver che opera al livello irQL più elevato.
DpcCallback

Routine fornita dal driver che viene chiamata per correggere gli errori che hanno causato l'eccezione di controllo del computer (MCE). Questa routine deve essere chiamata a DISPATCH_LEVEL.
DeviceContext

Contesto specifico del dispositivo per questo driver MCA.

Valore restituito

Restituisce STATUS_SUCCESS se la registrazione ha esito positivo.

Osservazioni

HalSetSystemInformation deve essere chiamato prima che un driver MCA possa usare qualsiasi altra routine di interfaccia. Un solo driver MCA può essere registrato con HAL in qualsiasi momento.

Windows Vista e versioni successive di Windows non supportano il tipo di creazione di report MCA (Machine Check Architecture) e McE (Machine Check Exception) descritti in questo argomento. La creazione di report MCA e MCE sono supportate tramite di Windows Hardware Error Architecture (WHEA).

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	ntddk.h (include Ntddk.h)

Condividi tramite