共用方式為

WdfDeviceAssignProperty 函式 (wdfdevice.h)

  • 發行項

[適用於 KMDF 和 UMDF]

WdfDeviceAssignProperty 方法會修改裝置屬性的目前設定。

語法

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

參數

[in] Device

架構裝置物件的句柄。

[in] DeviceProperty

識別要修改之裝置屬性 之WDF_DEVICE_PROPERTY_DATA 結構的指標。

[in] Type

DEVPROPTYPE 類型的變數，指定儲存在 Data 中的數據類型。

[in] Size

Data 所指向之緩衝區的大小，以位元組為單位。

[in, optional] Data

包含裝置屬性數據的呼叫端配置緩衝區指標。 將此參數設定為 NULL ，以刪除指定的屬性。

傳回值

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

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

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

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

備註

您可以使用 WdfDeviceAssignProperty 來修改透過統一屬性模型公開的任何屬性設定。

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

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.13
最低UMDF版本 2.0
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL APC_LEVEL

另請參閱

WdfDeviceAssignInterfaceProperty