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

Статья
08/08/2023

[Применимо к KMDF и UMDF]

Метод WdfUsbTargetDeviceGetDeviceDescriptor извлекает дескриптор USB-устройства для USB-устройства, связанного с указанным объектом УСТРОЙСТВА USB платформы.

Синтаксис

void WdfUsbTargetDeviceGetDeviceDescriptor(
  [in]  WDFUSBDEVICE           UsbDevice,
  [out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);

Параметры

[in] UsbDevice

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

[out] UsbDeviceDescriptor

Указатель на структуру, выделенную вызывающим объектом USB_DEVICE_DESCRIPTOR , которая получает дескриптор USB-устройства.

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

None

Remarks

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

Дополнительные сведения о методе WdfUsbTargetDeviceGetDeviceDescriptor и целевых объектах USB-ввода-вывода см. в разделе Usb I/O Targets.

Примеры

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

PMY_DEVICE_CONTEXT  myDeviceContext;

myDeviceContext = GetDeviceContext(device);

WdfUsbTargetDeviceGetDeviceDescriptor(
                                      myDeviceContext->UsbTargetDevice,
                                      &myDeviceContext->UsbDeviceDescr
                                      );

Требования

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

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

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters

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