[仅适用于 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。 其他返回值包括：
| 返回代码 | 描述 |
|---|---|
|
其中一个参数不正确。 |
此方法可能会返回其他 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