WdfDeviceAllocAndQueryProperty 函式 (wdfdevice.h)

[適用於 KMDF 和 UMDF]

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

語法

NTSTATUS WdfDeviceAllocAndQueryProperty(
  [in]           WDFDEVICE                Device,
  [in]           DEVICE_REGISTRY_PROPERTY DeviceProperty,
  [in]           POOL_TYPE                PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES   PropertyMemoryAttributes,
  [out]          WDFMEMORY                *PropertyMemory
);

參數

[in] Device

架構裝置物件的句柄。

[in] DeviceProperty

識別要擷取之裝置屬性 的DEVICE_REGISTRY_PROPERTY型別列舉值。

[in] PoolType

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

[in, optional] PropertyMemoryAttributes

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

[out] PropertyMemory

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

傳回值

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

傳回碼	Description
STATUS_INVALID_PARAMETER或STATUS_INVALID_PARAMETER_2	指定的 DeviceProperty 值無效。
STATUS_INVALID_DEVICE_REQUEST	裝置的驅動程式尚未回報裝置的屬性。

 

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

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

備註

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

或者，您可以使用 WdfDeviceAllocAndQueryPropertyEx 來存取透過整合屬性模型公開的裝置屬性。

範例

下列程式代碼範例會使用架構記憶體物件的屬性，初始化 WDF_OBJECT_ATTRIBUTES 結構，此物件會針對要求的屬性建立架構。 然後，此範例會呼叫 WdfDeviceAllocAndQueryProperty 來取得 DevicePropertyPhysicalDeviceObjectName 屬性。 在 WdfDeviceAllocAndQueryProperty 傳回之後，驅動程式可以呼叫 WdfMemoryGetBuffer，以取得包含名稱字串之緩衝區的指標。

WDF_OBJECT_ATTRIBUTES  attributes;
NTSTATUS  status;
WDFDEVICE  device;
WDFMEMORY  memory;

WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = device;

status = WdfDeviceAllocAndQueryProperty(device,
                                        DevicePropertyPhysicalDeviceObjectName,
                                        NonPagedPool,
                                        &attributes,
                                        &memory
                                        );
if (!NT_SUCCESS(status)) {
    return STATUS_UNSUCCESSFUL;
}

規格需求

需求	值
目標平台	Universal
最低 KMDF 版本	1.0
最低UMDF版本	2.0
標頭	wdfdevice.h (包含 Wdf.h)
程式庫	Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI 合規性規則	DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

WdfDeviceQueryProperty