共用方式為

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

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

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

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

言論

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

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

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.13
最低 UMDF 版本 2.0
標頭 wdfdevice.h （包括 Wdf.h）
連結庫 Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF）
IRQL APC_LEVEL

另請參閱

WdfDeviceAssignInterfaceProperty