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:

Código de retorno	Descrição
STATUS_INVALID_DEVICE_REQUEST	O IRQL do chamador era inválido.

 

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

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfusb.h (inclua Wdfusb.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Confira também

WdfUsbTargetDeviceCreateWithParameters