Função WdfUsbTargetDeviceIsConnectedSynchronous (wdfusb.h)

[Aplica-se somente ao KMDF]

O método WdfUsbTargetDeviceIsConnectedSynchronous determina se o dispositivo USB especificado está conectado.

Sintaxe

NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
  [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

WdfUsbTargetDeviceIsConnectedSynchronous retorna o valor de status de conclusão do destino de E/S 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_PARAMETER	Um parâmetro inválido foi detectado.
STATUS_INVALID_DEVICE_REQUEST	O IRQL do chamador era inválido.
STATUS_DEVICE_NOT_CONNECTED ou STATUS_DEVICE_DOES_NOT_EXIST	O dispositivo não estava conectado.

 

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

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

Exemplos

O exemplo de código a seguir determina se um dispositivo USB especificado está conectado.

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfusb.h (inclua Wdfusb.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
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