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

Функция WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)

  • Статья

[Относится только к UMDF]

Метод WdfDeviceAllocAndQueryInterfaceProperty выделяет буфер и извлекает указанное свойство интерфейса устройства.

Синтаксис

NTSTATUS WdfDeviceAllocAndQueryInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]           POOL_TYPE                           PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES              PropertyMemoryAttributes,
  [out]          WDFMEMORY                           *PropertyMemory,
  [out]          PDEVPROPTYPE                        Type
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] PropertyData

Указатель на структуру WDF_DEVICE_INTERFACE_PROPERTY_DATA , которая определяет извлекаемое свойство интерфейса устройства.

[in] PoolType

Перечислитель с POOL_TYPE типом, указывающий тип выделенной памяти.

[in, optional] PropertyMemoryAttributes

Указатель на структуру, выделенную вызывающим объектом WDF_OBJECT_ATTRIBUTES , которая описывает атрибуты объекта для объекта памяти, который будет выделять функция. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

[out] PropertyMemory

Указатель на расположение типа WDFMEMORY, которое получает дескриптор объекта памяти платформы.

[out] Type

Указатель на переменную типа DEVPROPTYPE, которая при возврате определяет тип данных свойства, содержащихся в PropertyMemory.

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

Если метод WdfDeviceAllocAndQueryInterfaceProperty не обнаруживает ошибок, он возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Код возврата Описание
STATUS_INVALID_PARAMETER
 Один из параметров неверен.
 

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

Комментарии

Метод WdfDeviceAllocAndQueryInterfaceProperty определяет объем памяти, необходимый для хранения запрошенного свойства интерфейса устройства. Он выделяет достаточно памяти для хранения данных и возвращает дескриптор объекту памяти платформы, который описывает выделенную память. Для доступа к данным драйвер может вызвать WdfMemoryGetBuffer.

Сведения о связанных методах см. в разделе Доступ к модели унифицированных свойств устройства.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1
Целевая платформа Универсальное
Минимальная версия UMDF 2,0
Верхняя часть wdfdevice.h (включая Wdf.h)
Библиотека WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

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

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty