Função WdfUsbTargetDeviceResetPortSynchronously (wdfusb.h)

[Aplica-se a KMDF e UMDF]

O método WdfUsbTargetDeviceResetPortSynchronously redefine a porta USB associada ao dispositivo USB especificado.

Sintaxe

NTSTATUS WdfUsbTargetDeviceResetPortSynchronously(
  [in] WDFUSBDEVICE UsbDevice
);

Parâmetros

[in] UsbDevice

Um identificador para um objeto de dispositivo USB que foi obtido de uma chamada anterior para WdfUsbTargetDeviceCreateWithParameters.

Retornar valor

WdfUsbTargetDeviceResetPortSynchronously retorna a conclusão do destino de E/S USB status valor se a operação for bem-sucedida. Caso contrário, esse método pode retornar um dos seguintes valores:

Esse método também pode retornar outros valores NTSTATUS.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

O método WdfUsbTargetDeviceResetPortSynchronously redefine a porta USB enviando uma solicitação IOCTL_INTERNAL_USB_RESET_PORT .

Antes que a estrutura redefina a porta USB do destino de E/S, ela cancela todas as solicitações de E/S que permanecem na fila do destino de E/S. O driver não deve enviar solicitações de E/S adicionais para o destino de E/S até que WdfUsbTargetDeviceResetPortSynchronously retorne.

O driver deve chamar WdfIoTargetStop antes de chamar WdfUsbTargetDeviceResetPortSynchronously. Depois que WdfUsbTargetDeviceResetPortSynchronously retornar, o driver poderá chamar WdfIoTargetStart.

Após uma operação de redefinição bem-sucedida, o driver de barramento reelegerá a configuração e as configurações de interface alternativas que o dispositivo tinha antes da operação de redefinição ocorrer.

Para obter mais informações sobre o método WdfUsbTargetDeviceResetPortSynchronously e destinos de E/S USB, consulte Destinos de E/S USB.

Exemplos

O exemplo de código a seguir redefine a porta USB de um dispositivo especificado.

NTSTATUS status;

status = WdfUsbTargetDeviceResetPortSynchronously(UsbDevice);

Requisitos

Confira também

WdfUsbTargetDeviceCreateWithParameters