Поделиться через

Функция WdfUsbTargetDeviceIsConnectedSynchronous (wdfusb.h)

  • Статья

[Применяется только к KMDF]

Метод WdfUsbTargetDeviceIsConnectedSynchronous определяет, подключено ли указанное USB-устройство.

Синтаксис

NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
  [in] WDFUSBDEVICE UsbDevice
);

Параметры

[in] UsbDevice

Дескриптор объекта USB-устройства, полученный при предыдущем вызове WdfUsbTargetDeviceCreateWithParameters.

Возвращаемое значение

WdfUsbTargetDeviceIsConnectedSynchronous возвращает значение состояния завершения целевого объекта ввода-вывода, если операция выполнена успешно. В противном случае этот метод может вернуть одно из следующих значений:

Код возврата Описание
STATUS_INVALID_PARAMETER
 Обнаружен недопустимый параметр.
STATUS_INVALID_DEVICE_REQUEST
 IrQL вызывающего абонента был недопустим.
STATUS_DEVICE_NOT_CONNECTED или STATUS_DEVICE_DOES_NOT_EXIST
 Устройство не подключено.
 

Этот метод также может возвращать другие значения NTSTATUS.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

Дополнительные сведения о методе WdfUsbTargetDeviceIsConnectedSynchronous и целевых объектах ввода-вывода USB см. в разделе Целевые объекты ввода-вывода USB.

Примеры

В следующем примере кода определяется, подключено ли указанное USB-устройство.

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfusb.h (включая Wdfusb.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL PASSIVE_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

См. также раздел

WdfUsbTargetDeviceCreateWithParameters