Função NetDeviceStoreResetDiagnostics (netadaptercx.h)
A função NetDeviceStoreResetDiagnostics armazena o diagnóstico de redefinição coletado pelo driver cliente na estrutura NetAdapterCx.
Sintaxe
void NetDeviceStoreResetDiagnostics(
[_In_] WDFDEVICE Device,
[_In_] SIZE_T ResetDiagnosticsSize,
[_In_reads_bytes_(ResetDiagnosticsSize)] const UINT8 *ResetDiagnosticsBuffer
);
Parâmetros
[_In_] Device
O objeto WDFDEVICE que o driver cliente criou anteriormente com uma chamada para WdfDeviceCreate.
[_In_] ResetDiagnosticsSize
O tamanho em bytes do ResetDiagnosticsBuffer. O tamanho máximo do diagnóstico de redefinição aceito pela estrutura é de 1 MB.
[_In_reads_bytes_(ResetDiagnosticsSize)] ResetDiagnosticsBuffer
Um ponteiro para o buffer de dados que contém os dados de diagnóstico de redefinição. O buffer de dados pode vir de um pool de páginas ou não de páginas.
Valor de retorno
Nenhum
Observações
O único cenário válido para invocar a função NetDeviceStoreResetDiagnostics está no retorno de chamada EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS de um driver cliente. O driver cliente deve chamar NetDeviceStoreResetDiagnostics em PASSIVE_LEVEL
Para saber como usar corretamente a função NetDeviceStoreResetDiagnostics, 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 |