Funzione WheaAddErrorSourceDeviceDriver (ntddk.h)
Un driver di dispositivo chiama WheaAddErrorSourceDeviceDriver per aggiungere un'origine di 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 contenente un set di routine di callback fornite dal driver.
NumberPreallocatedErrorReports
Valore di tipo ULONG che specifica il numero di record da preallocare. Per ulteriori informazioni, vedere la sezione Osservazioni.
Valore restituito
Questo metodo di funzione restituisce STATUS_SUCCESS se viene aggiunta l'origine degli errori. 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 è in grado di allocare spazio per l'origine degli errori e i relativi record.
Commenti
Per rimuovere un'origine di errore, il driver chiama WheaRemoveErrorSourceDeviceDriver.
WHEA può preallocare la memoria per gli errori che verranno segnalati ad alto irQL (ad esempio nel contesto di un interruzione del dispositivo). Per le origini di errore segnalate in PASSIVE_LEVEL, la preallocation non è necessaria, ma se il driver del dispositivo segnala errori per l'origine degli errori in DISPATCH_LEVEL o superiore, i record di errore devono essere preallocati.
Per altre informazioni, vedere Uso di WHEA in Windows 10.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 2004 |
| Intestazione | ntddk.h |