共用方式為

WdfFdoInitAllocAndQueryPropertyEx 函式 （wdffdo.h）

  • 發行項

[適用於 KMDF 和 UMDF]

WdfFdoInitAllocAndQueryPropertyEx 方法會配置緩衝區並擷取指定的裝置屬性。

語法

NTSTATUS WdfFdoInitAllocAndQueryPropertyEx(
  [in]           PWDFDEVICE_INIT           DeviceInit,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           POOL_TYPE                 PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES    PropertyMemoryAttributes,
  [out]          WDFMEMORY                 *PropertyMemory,
  [out]          PDEVPROPTYPE              Type
);

參數

[in] DeviceInit

驅動程式從其 EvtDriverDeviceAdd 回呼函式取得之 WDFDEVICE_INIT 結構的指標。

[in] DeviceProperty

識別要擷取之裝置屬性之 WDF_DEVICE_PROPERTY_DATA 結構的指標。

[in] PoolType

POOL_TYPE型別列舉值，指定要配置的記憶體類型。

[in, optional] PropertyMemoryAttributes

呼叫端配置的 WDF_OBJECT_ATTRIBUTES 結構的指標，描述函式將配置之內存物件的物件屬性。 這個參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[out] PropertyMemory

接收架構記憶體物件句柄之 WDFMEMORY 型別位置的指標。

[out] Type

DEVPROPTYPE 變數的指標。 如果方法成功，傳回此參數時，會包含儲存在 PropertyMemory 屬性資料的屬性值，。

返回值

如果作業成功，WdfFdoInitAllocAndQueryPropertyEx 會傳回STATUS_SUCCESS。 其他傳回值包括：

回傳碼 說明
STATUS_INVALID_PARAMETER
 指定的 DeviceProperty 值無效。
 

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

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

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

驅動程式只能在呼叫 WdfDeviceCreate之前呼叫 WdfFdoInitAllocAndQueryPropertyEx。 如需呼叫 WdfDeviceCreate的詳細資訊，請參閱 建立 Framework Device Object。

呼叫 WdfDeviceCreate之後，驅動程式可以呼叫 WdfDeviceAllocAndQueryPropertyEx來取得裝置屬性資訊。

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

需求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.13
最低 UMDF 版本 2.0
標題 wdffdo.h （包括 Wdf.h）
程式庫 Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF）
IRQL PASSIVE_LEVEL

另請參閱

WdfFdoInitAllocAndQueryProperty