Función WheaFindNextErrorRecordSection (ntddk.h)
La función WheaFindNextErrorRecordSection permite a un autor de la llamada examinar iterativamente las secciones de registro de errores de WHEA dentro de un registro de error WHEA. Cada sección de registro de error tiene el formato de estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Sintaxis
NTSTATUS WheaFindNextErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in, out] ULONG *Context,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
Parámetros
[in] Record
Puntero a un registro de error WHEA con formato de estructura WHEA_ERROR_RECORD .
[in, out] Context
Puntero a una variable ULONG que mantiene el estado actual de la búsqueda.
Esta variable debe inicializarse en cero antes de la primera llamada a la función WheaFindNextErrorRecordSection .
[out] SectionDescriptor
Dirección de un puntero WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Si la función WheaFindNextErrorRecordSection busca la siguiente estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro del registro de error WHEA especificado, la función establece el parámetro SectionDescriptor en la dirección de esa estructura dentro del registro de error WHEA especificado.
[out, optional] SectionData
Dirección de un puntero PVOID.
Si la función WheaFindNextErrorRecordSection busca la siguiente estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro del registro de error WHEA especificado, la función establece el parámetro SectionData en la dirección de los datos de error de hardware asociados a ese descriptor.
Este parámetro es opcional y debe establecerse en NULL si no se requiere un puntero a los datos de sección del registro de errores.
Valor devuelto
WheaFindNextErrorRecordSection devuelve uno de los siguientes códigos NTSTATUS:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | Se encontró la siguiente estructura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR . |
| STATUS_NOT_FOUND | No se encontró la siguiente estructura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR . |
| STATUS_INVALID_PARAMETER | Los parámetros Record, SectionType o SectionDescriptor se establecieron en NULL o los datos WHEA_ERROR_RECORD a los que se hace referencia a través del parámetro Record no son válidos. |
Comentarios
Si el parámetro Context se establece en 0, WheaFindNextErrorRecordSection devuelve un puntero a la primera estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro de un registro de error WHEA. WheaFindNextErrorRecordSection también actualizará el parámetro Context con información de estado relacionada con el WHEA_ERROR_RECORD_SECTION_DESCRIPTOR devuelto a través del parámetro SectionDescriptor .
En las llamadas posteriores a WheaFindNextErrorRecordSection, la función devuelve la siguiente estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR (si está disponible) dentro del registro de error WHEA. Si la función busca la siguiente estructura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR, actualizará el parámetro Context . De lo contrario, la función devolverá STATUS_NOT_FOUND.
Para buscar el primer WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro del registro de error WHEA especificado, el autor de la llamada debe establecer la variable, cuya dirección se pasa en el parámetro Context , en 0 antes de la llamada. Después, el autor de la llamada no debe modificar el valor de la variable al buscar el siguiente WHEA_ERROR_RECORD_SECTION_DESCRIPTOR mediante llamadas posteriores a WheaFindNextErrorRecordSection.
Además, si WheaFindNextErrorRecordSection 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 de 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 estructura WHEA_PROCESSOR_GENERIC_ERROR_SECTION .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con Windows 7 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | ntddk.h (incluya Ntddk.h) |
| IRQL | IRQL <= DISPATCH_LEVEL |