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

Статья
02/07/2025

[Применимо только к 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 (include Wdfusb.h)
библиотеки	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

См. также

WdfUsbTargetDeviceCreateWithParameters

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