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 |
|---|---|
|
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) |