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é-fabricados. Consulte Comentários para obter mais informações.
Valor de retorno
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.
Observações
Para remover uma fonte de erro, o driver chama wheaRemoveErrorSourceDeviceDriver.
O WHEA pode pré-alocar memória para erros que serão relatados em IRQL alto (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 do dispositivo relatar erros para sua fonte 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 no Windows 10.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 10, versão 2004 |
cabeçalho | ntddk.h |