Função UdecxWdfDeviceNeedsReset (udecxwdfdevice.h)

  • Artigo

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_TYPE que indica o tipo de redefinição. Só UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset há suporte no momento.

Retornar valor

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

Comentários

Se uma operação de redefinição existente estiver em andamento, a função falhará com um erro de STATUS_DEVICE_BUSY. Observe que só UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset há suporte no momento. UdecxWdfDeviceResetAttemptFunctionLevelDeviceReset não é suportado.

Requisitos

Requisito Valor
Versão mínima do KMDF 1.27
Versão mínima do UMDF N/D
Cabeçalho udecxwdfdevice.h (include Udecx.h)
Biblioteca Udecxstub.lib
IRQL PASSIVE_LEVEL

Confira também

UDECX_WDF_DEVICE_RESET_TYPE