funzione di callback pHalSetSystemInformation (ntddk.h)

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 riavviabili del gestore di Controllo computer (MCE), prima che venga generata una verifica di 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 corretta della CPU di un driver e HalCpeRegisterDriver per registrare l'errore della piattaforma corretta di un driver DpcCallback.

[in] BufferSize

Dimensioni, in byte, del buffer fornito dal chiamante.

[out] Buffer

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

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

  La routine fornita dal driver da chiamare quando si verifica l'eccezione controllo computer (MCE) per errori non corretti. Un driver non può usare in modo esplicito i servizi del kernel o le routine di blocco spin. Il gestore è limitato agli stessi vincoli di un driver che opera al massimo irQL.

• DpcCallback

  Routine fornita dal driver che viene chiamata per gli errori corretti che hanno causato l'eccezione controllo computer (MCE). Questa routine deve essere chiamata in DISPATCH_LEVEL.

• DeviceContext

  Contesto specifico del dispositivo per questo driver MCA.

Valore restituito

Restituisce STATUS_SUCCESS se la registrazione ha esito positivo.

Commenti

HalSetSystemInformation deve essere chiamato prima che un driver MCA possa usare una qualsiasi delle altre routine di interfaccia. È possibile registrare un solo driver MCA con HAL in qualsiasi momento.

Windows Vista e versioni successive di Windows non supportano il tipo di report MCA (Machine Check Architecture) e Machine Check Exception (MCE) descritto in questo argomento. I report MCA e MCE sono supportati tramite l'architettura degli errori hardware di Windows (WHEA).

Requisiti