Функция WdfUsbTargetDeviceGetDeviceDescriptor (wdfusb.h)
[Применимо к 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-устройства.
Возвращаемое значение
Никакой
Замечания
Ошибка возникает, если дескриптор объекта, предоставленный драйвером, является недопустимым.
Дополнительные сведения о методе WdfUsbTargetDeviceGetDeviceDescriptor и целевых объектов USB-ввода-вывода см. в целевых объектов USB-ввода-вывода.
Примеры
Следующий пример кода получает дескриптор USB-устройства для устройства. В примере хранится дескриптор в пространстве контекста, определяемом драйвером.
PMY_DEVICE_CONTEXT myDeviceContext;
myDeviceContext = GetDeviceContext(device);
WdfUsbTargetDeviceGetDeviceDescriptor(
myDeviceContext->UsbTargetDevice,
&myDeviceContext->UsbDeviceDescr
);
Требования
Требование | Ценность |
---|---|
целевая платформа | Всеобщий |
минимальная версия KMDF | 1.0 |
минимальная версия UMDF | 2.0 |
заголовка | wdfusb.h (include 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) |