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。 其他傳回值包括：

傳回碼	Description
STATUS_INVALID_PARAMETER	其中一個參數不正確。

 

方法可能會傳回其他 NTSTATUS值。

備註

WdfDeviceAllocAndQueryInterfaceProperty 方法會決定保存要求之裝置介面屬性所需的記憶體數量。 它會配置足夠的記憶體來保存數據，並將句柄傳回描述已配置記憶體的架構記憶體物件。 若要存取數據，您的驅動程式可以呼叫 WdfMemoryGetBuffer。

如需相關方法的相關信息，請參閱 存取整合裝置屬性模型。

規格需求

需求	值
最低支援的用戶端	Windows 8.1
目標平台	Universal
最低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