Função NetDeviceRequestReset (netadaptercx.h)

  • Artigo

A função NetDeviceRequestReset dispara a estrutura NetAdapterCx para executar a operação de redefinição de dispositivo no nível da plataforma que recupera um dispositivo NIC sem resposta.

Sintaxe

void NetDeviceRequestReset(
  [_In_] WDFDEVICE Device
);

Parâmetros

[_In_] Device

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

Retornar valor

Nenhum

Comentários

Um driver cliente chama NetDeviceRequestReset quando detecta uma falha no dispositivo. NetDeviceRequestReset retorna imediatamente para o driver cliente. O driver só pode chamar NetDeviceRequestReset em PASSIVE_LEVEL.

NetDeviceRequestReset não está desbloqueando e retorna imediatamente para o driver cliente. O driver do cliente deve cancelar todos os trabalhos em andamento que acessam o dispositivo com falha no momento.

Recomendamos que os drivers de cliente configurem uma estrutura de NET_DEVICE_RESET_CAPABILITIES para coletar diagnóstico de redefinição significativas durante o processo de recuperação e redefinição do dispositivo. Para obter mais informações sobre como coletar diagnóstico de redefinição, consulte Registrar o retorno de chamada opcional diagnóstico coleção.

NetDeviceRequestReset só é aplicável a dispositivos NIC baseados em PCIe. Para dispositivos NIC baseados em USB, siga o processo descrito em Como se recuperar de erros de pipe USB.

Se o dispositivo encontrar um erro de hardware ou software irrecuperável, o driver cliente poderá usar a função WdfDeviceSetFailed .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11
Servidor mínimo com suporte Windows Server 2022
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