Função UdecxWdfDeviceNeedsReset (udecxwdfdevice.h)

Artigo
02/07/2025

Informa à extensão de classe de emulação de dispositivo USB (UdeCx) que o dispositivo precisa de uma operação de redefinição.

Sintaxe

NTSTATUS UdecxWdfDeviceNeedsReset(
  [In] WDFDEVICE                   UdeWdfDevice,
  [In] UDECX_WDF_DEVICE_RESET_TYPE ResetType
);

Parâmetros

[In] UdeWdfDevice

Um identificador para um objeto de dispositivo de estrutura que representa um dispositivo USB. O driver cliente inicializou esse objeto na chamada anterior para UdecxWdfDeviceAddUsbDeviceEmulation.

[In] ResetType

Um valor de tipo UDECX_WDF_DEVICE_RESET_TYPEque indica o tipo de redefinição. Somente UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset tem suporte neste momento.

Valor de retorno

A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retornará um código de erro de NTSTATUS apropriado.

Observações

Se uma operação de redefinição existente estiver em andamento, a função falhará com um erro STATUS_DEVICE_BUSY. Observe que somente UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset tem suporte neste momento. não há suporte para UdecxWdfDeviceResetAttemptFunctionLevelDeviceReset.

Requisitos

Requisito	Valor
versão mínima do KMDF	1.27
versão mínima do UMDF	N/A
cabeçalho	udecxwdfdevice.h (inclua Udecx.h)
biblioteca	Udecxstub.lib
IRQL	PASSIVE_LEVEL

Consulte também

UDECX_WDF_DEVICE_RESET_TYPE

Compartilhar via