WdfDeviceAssignInterfaceProperty 関数 (wdfdevice.h)

WdfDeviceAssignInterfaceProperty メソッドは、デバイス インターフェイス プロパティの現在の値を変更します。

構文

NTSTATUS WdfDeviceAssignInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]           DEVPROPTYPE                         Type,
  [in]           ULONG                               BufferLength,
  [in, optional] PVOID                               PropertyBuffer
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] PropertyData

WDF_DEVICE_INTERFACE_PROPERTY_DATA 構造体へのポインター。

[in] Type

DEVPROPTYPEPropertyBuffer で提供されるデータの型を指定する型指定された値指定します。

[in] BufferLength

PropertyBuffer が指 バッファーの長さをバイト単位で指定します。

[in, optional] PropertyBuffer

デバイス インターフェイスのプロパティ データへのポインター。 指定したプロパティを削除するには、このパラメーター NULL に設定します。

戻り値

WdfDeviceAssignInterfaceProperty メソッドでエラーが発生しなかった場合は、STATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

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

備考

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

例

次のコード例では、WDF_DEVICE_INTERFACE_PROPERTY_DATA 構造体を初期化し、WdfDeviceAssignInterfacePropertyを呼び出します。

DEFINE_DEVPROPKEY(DEVPKEY_ToasterCrispLevelDword, 0x5d0ba64a, 0x2396, 0x4bc9, 0xbf, 0x49, 0x52, 0x1d, 0xa6, 0x2b, 0x1b, 0xed, 3);  // DEVPROP_TYPE_UINT32

ULONG crispLevel = 0;
WDF_DEVICE_INTERFACE_PROPERTY_DATA propertyData;

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT(
                          &propertyData, 
                          &GUID_DEVINTERFACE_TOASTER_DRIVER
                          &DEVPKEY_ToasterCrispLevelDword
                          );

status = WdfDeviceAssignInterfaceProperty(device, 
                                          &propertData,
                                          DEVPROP_TYPE_UINT32,
                                          sizeof(crispLevel),
                                          &crispLevel);
if (!NT_SUCCESS(status)) {
    return status;
}

必要条件

関連項目

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAllocAndQueryInterfaceProperty の

WdfDeviceQueryInterfaceProperty の