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）
連結庫	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

另請參閱

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty