次の方法で共有

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データ に格納されているデータの型を指定する型指定された変数します。

[in] Size

Dataが指すバッファーのサイズ (バイト単位)。

[in, optional] Data

デバイス プロパティ データを含む呼び出し元によって割り当てられたバッファーへのポインター。 指定したプロパティを削除するには、このパラメーター NULL に設定します。

戻り値

操作が成功した場合、WdfDeviceAssignProperty はSTATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

リターン コード 形容
STATUS_INVALID_PARAMETER
 パラメーターの 1 つが正しくありません。
 

このメソッドは、他NTSTATUS 値を返す場合があります。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

備考

WdfDeviceAssignProperty を使用して、統合プロパティ モデルを通じて公開されるプロパティの設定を変更できます。

関連するメソッドの詳細については、「統合デバイス プロパティ モデルへのアクセス」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.13
UMDF の最小バージョン を する 2.0
ヘッダー wdfdevice.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL APC_LEVEL

関連項目

WdfDeviceAssignInterfaceProperty の