Función WheaFindErrorRecordSection (ntddk.h)

La función WheaFindErrorRecordSection busca una sección de registro de error de arquitectura de errores de hardware (WHEA) especificada dentro de un registro de error de WHEA . La sección de registro de errores tiene el formato de estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.

Sintaxis

NTSTATUS WheaFindErrorRecordSection(
  [in]            PWHEA_ERROR_RECORD                    Record,
  [in]            const GUID                            *SectionType,
  [out]           PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
  [out, optional] PVOID                                 *SectionData
);

Parámetros

[in] Record

Puntero a un registro de error WHEA que tiene el formato de estructura WHEA_ERROR_RECORD.

[in] SectionType

GUID que especifica la estructura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR que se va a ubicar dentro del registro de error de WHEA especificado .

[out] SectionDescriptor

Dirección de un puntero WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.

Si la función WheaFindErrorRecordSection busca la estructura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada, la función establece el parámetro sectionDescriptor en la dirección de esa estructura dentro del registro de error de WHEA especificado .

[out, optional] SectionData

Dirección de un puntero PVOID.

Si la función WheaFindErrorRecordSection localiza la estructura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada, la función establece el parámetro SectionData en la dirección de los datos de error de hardware asociados a ese descriptor dentro del registro de error de WHEA especificado .

Este parámetro es opcional y debe establecerse en null si no se requiere un puntero a los datos de error de hardware.

Valor devuelto

WheaFindErrorRecordSection devuelve uno de los siguientes códigos NTSTATUS:

Observaciones

Si WheaFindErrorRecordSection devuelve STATUS_SUCCESS, se encuentra la estructura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada a través del parámetro guid de. WheaFindErrorRecordSection establece el parámetro SectionDescriptor en la dirección de la estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR ubicada.

Además, si WheaFindErrorRecordSection devuelve STATUS_SUCCESS y el autor de la llamada establece el parámetro SectionData en la dirección de una variable de puntero PVOID, la función actualiza el parámetro con la dirección de los datos de error de hardware asociados a la estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada.

El formato de los datos de error de hardware depende del miembro SectionType de la estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR a la que se hace referencia a través del parámetro sectionDescriptor . Por ejemplo, si el miembro SectionType tiene el valor PROCESSOR_GENERIC_ERROR_SECTION_GUID, los datos de error de hardware tienen el formato de una estructura WHEA_PROCESSOR_GENERIC_ERROR_SECTION.

Requisitos

Consulte también

registro de errores

WHEA_ERROR_RECORD

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR