Função NetDeviceRequestReset (netadaptercx.h)
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.
Valor de retorno
Nenhum
Observações
Um driver cliente chama NetDeviceRequestReset quando detecta uma falha no dispositivo. NetDeviceRequestReset retorna imediatamente ao driver cliente. O driver só pode chamar NetDeviceRequestReset em PASSIVE_LEVEL.
NetDeviceRequestReset não está sendo desbloqueado e retorna imediatamente ao driver cliente. O driver 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 NET_DEVICE_RESET_CAPABILITIES para coletar diagnósticos de redefinição significativos durante o processo de redefinição e recuperação do dispositivo. Para obter mais informações sobre como coletar diagnósticos de redefinição, consulte Registrar ode retorno de chamada de coleta de diagnóstico opcional.
netDeviceRequestReset só é aplicável para dispositivos NIC baseados em PCIe. Para dispositivos NIC baseados em USB, siga o processo descrito em Como 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 |
|---|---|
| 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 |