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

Статья
02/07/2025

[Применимо только к 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.

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

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

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	Один из параметров является неверным.

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

Замечания

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8.1
целевая платформа	Всеобщий
минимальная версия UMDF	2.0
заголовка	wdfdevice.h (include Wdf.h)
библиотеки	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

См. также

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

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