Funzione WheaAddErrorSourceDeviceDriver (ntddk.h)

Articolo
02/07/2025

Un driver di dispositivo chiama WheaAddErrorSourceDeviceDriver per aggiungere un'origine errore.

Sintassi

NTSTATUS WheaAddErrorSourceDeviceDriver(
  PVOID                                          Context,
  PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
  ULONG                                          NumberPreallocatedErrorReports
);

Parametri

Context

Puntatore facoltativo a un contesto allocato dal chiamante. WHEA fornisce il contesto come parametro per le routine di callback fornite dal driver. Può essere NULL.

Configuration

Puntatore a una struttura di tipo WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER che contiene un set di routine di callback fornite dal driver.

NumberPreallocatedErrorReports

Valore di tipo ULONG che specifica il numero di record da preallocare. Per altre informazioni, vedere La sezione Osservazioni.

Valore restituito

Questo metodo di funzione restituisce STATUS_SUCCESS se viene aggiunta l'origine dell'errore. In caso contrario, può restituire uno dei seguenti elementi:

STATUS_INVALID_PARAMETER: la configurazione manca l'inizializzazione e/o l'inizializzazione dei puntatori di callback.
STATUS_INVALID_PARAMETER_2: è stata inviata una configurazione con una versione non valida.
STATUS_INSUFFICIENT_RESOURCES: WHEA non è riuscito ad allocare spazio per l'origine dell'errore e i relativi record.

Osservazioni

Per rimuovere un'origine di errore, il driver chiama WheaRemoveErrorSourceDeviceDriver.

WHEA può preallocare la memoria per gli errori che verranno segnalati a irQL elevato (ad esempio nel contesto di un interrupt del dispositivo). Per le origini degli errori segnalate in PASSIVE_LEVEL, la preallocazione non è necessaria, ma se il driver di dispositivo segnala errori per l'origine degli errori in DISPATCH_LEVEL o superiore, i record di errore devono essere preallocati.

Per altre info, vedi Uso di WHEA in Windows 10.