Função WheaAddErrorSourceDeviceDriver (ntddk.h)
Um driver de dispositivo chama WheaAddErrorSourceDeviceDriver para adicionar uma fonte de erro.
Sintaxe
NTSTATUS WheaAddErrorSourceDeviceDriver(
PVOID Context,
PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
ULONG NumberPreallocatedErrorReports
);
Parâmetros
Context
Um ponteiro opcional para um contexto alocado pelo chamador. O WHEA fornece o contexto como um parâmetro para rotinas de retorno de chamada fornecidas pelo driver. Pode ser NULL.
Configuration
Ponteiro para uma estrutura do tipo WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER que contém um conjunto de rotinas de retorno de chamada fornecidas pelo driver.
NumberPreallocatedErrorReports
Um valor do tipo ULONG que especifica o número de registros a serem pré-alocados. Confira Comentários para obter mais informações.
Retornar valor
Esse método de função retornará STATUS_SUCCESS se a origem do erro for adicionada. Caso contrário, ele poderá retornar um dos seguintes:
- STATUS_INVALID_PARAMETER: a configuração está ausente inicializar e/ou não inicializar ponteiros de retorno de chamada.
- STATUS_INVALID_PARAMETER_2: uma configuração com uma versão inválida foi enviada.
- STATUS_INSUFFICIENT_RESOURCES: o WHEA não pôde alocar espaço para a origem do erro e seus registros.
Comentários
Para remover uma fonte de erro, o driver chama WheaRemoveErrorSourceDeviceDriver.
O WHEA pode pré-alocar memória para erros que serão relatados em ALTO IRQL (ou seja, no contexto de uma interrupção do dispositivo). Para fontes de erro relatadas em PASSIVE_LEVEL, a pré-alocação não é necessária, mas se o driver de dispositivo relatar erros para sua origem de erro em DISPATCH_LEVEL ou superior, os registros de erro deverão ser pré-alocados.
Para obter mais informações, consulte Usando o WHEA em Windows 10.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 2004 |
| Cabeçalho | ntddk.h |