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。 其他傳回值包括:
傳回碼 | 描述 |
---|---|
|
其中一個參數不正確。 |
方法可能會 傳回其他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