Funzione WheaReportHwErrorDeviceDriver (ntddk.h)

Per segnalare un errore hardware, il driver chiama la funzione WheaReportHwErrorDeviceDriver .

Sintassi

NTSTATUS WheaReportHwErrorDeviceDriver(
  ULONG               ErrorSourceId,
  PDEVICE_OBJECT      DeviceObject,
  PUCHAR              ErrorData,
  ULONG               ErrorDataLength,
  LPGUID              SectionTypeGuid,
  WHEA_ERROR_SEVERITY ErrorSeverity,
  LPSTR               DeviceFriendlyName
);

Parametri

ErrorSourceId

L'ID di origine dell'errore WHEA fornito quando ha chiamato il callback _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER .

DeviceObject

Puntatore all'oggetto dispositivo associato alla condizione di errore.

ErrorData

Buffer contenente i dati di errore hardware del driver. Queste informazioni sono specifiche dell'hardware e non devono superare maxRawDataLength che il driver fornito a WheaAddErrorSourceDeviceDriver .

ErrorDataLength

Valore di tipo ULONG che specifica le dimensioni, in byte, dei dati di errore.

SectionTypeGuid

Specifica il tipo di dati di errore segnalati. Questo può essere, ma non è necessario, uno dei GUID definiti nell'appendice N della specifica UEFI, nel qual caso le informazioni sull'errore corrispondono a uno dei tipi di sezione specificati. Il chiamante può anche creare un formato GUID e sezione privata.

ErrorSeverity

Valore di enumerazione di tipo WHEA_ERROR_SEVERITY che specifica la gravità della condizione di errore.

DeviceFriendlyName

Stringa facoltativa fino a 20 byte di lunghezza (incluso il terminatore NULL) che descrive il dispositivo associato alla condizione di errore. Queste informazioni vengono copiate nel record di errore WHEA risultante ed è solo informativo. La finalità consiste nel inserire queste informazioni nel record di errore in modo che quando i log eventi vengono creati un consumer può risolvere facilmente i problemi del dispositivo.

Valore restituito

Questo metodo di funzione restituisce STATUS_SUCCESS o un codice di errore appropriato.

Requisiti

Vedi anche

WheaAddErrorSourceDeviceDriver

WheaRemoveErrorSourceDeviceDriver