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ósticos de um dispositivo de hardware com falha e denunciá-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.

Valor de retorno

Nenhum

Observações

Se fornecida, a estrutura NetAdapterCx invocará o retorno de chamada EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS para coletar o 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
de cliente com suporte mínimo Windows 11
servidor com suporte mínimo Windows Server 2022
versão mínima do UMDF 2.33
cabeçalho netadaptercx.h (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL

Consulte também

Recuperando uma NIC sem resposta com netAdapterCx PLDR

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES