Compartilhar via


EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS função de retorno de chamada (netadaptercx.h)

Implemente esse retorno de chamada opcional para coletar diagnóstico de um dispositivo de hardware com falha e reportá-lo à estrutura NetAdapterCx durante o processo de redefinição e recuperação do dispositivo.

Sintaxe

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS EvtNetDeviceCollectResetDiagnostics;

void EvtNetDeviceCollectResetDiagnostics(
  [_In_] WDFDEVICE Device
)
{...}

Parâmetros

[_In_] Device

O objeto WDFDEVICE que o driver cliente obteve anteriormente com uma chamada para WdfDeviceCreate.

Retornar valor

Nenhum

Comentários

Se fornecida, a estrutura NetAdapterCx invocará o retorno de chamada EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS para coletar diagnóstico de redefinição durante o processo de redefinição e recuperação. A estrutura sempre invoca esse retorno de chamada em PASSIVE_LEVEL.

O campo EvtNetDeviceCollectResetDiagnostics da estrutura de dados NET_DEVICE_RESET_CAPABILITIES refere-se a esse retorno de chamada.

Para saber como implementar corretamente esse retorno de chamada e obter mais informações sobre a garantia de sincronização da estrutura, consulte Implementar EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11
Servidor mínimo com suporte Windows Server 2022
Versão mínima do UMDF 2.33
Cabeçalho netadaptercx.h (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL

Confira também

Recuperando uma NIC sem resposta com NetAdapterCx PLDR

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES