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)
Library WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

另请参阅

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty