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

Статья
08/08/2023

[Относится только к 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