IoSetDeviceInterfacePropertyData 関数 (wdm.h)

IoSetDeviceInterfacePropertyData ルーチンは、デバイス インターフェイス プロパティの現在の値を変更します。

構文

NTSTATUS IoSetDeviceInterfacePropertyData(
  [in]           PUNICODE_STRING  SymbolicLinkName,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           LCID             Lcid,
  [in]           ULONG            Flags,
  [in]           DEVPROPTYPE      Type,
  [in]           ULONG            Size,
  [in, optional] PVOID            Data
);

パラメーター

[in] SymbolicLinkName

デバイス インターフェイス インスタンスを識別する文字列へのポインター。 この文字列は、IoGetDeviceInterfaces、IoGetDeviceInterfaceAlias、または IoRegisterDeviceInterface ルーチン 以前の呼び出しから取得されました。

[in] PropertyKey

デバイス インターフェイスのプロパティ キーを含む DEVPROPKEY 構造体へのポインター。

[in] Lcid

ロケール識別子を指定します。 このパラメーターは、言語固有の LCID 値または LOCALE_NEUTRALに設定します。 LOCALE_NEUTRAL LCID は、プロパティが言語に依存しないことを指定します (つまり、どの言語にも固有ではありません)。 このパラメーターを LOCALE_SYSTEM_DEFAULT または LOCALE_USER_DEFAULTに設定しないでください。 言語固有の LCID 値の詳細については、「LCID 構造体 を参照してください。

[in] Flags

このルーチンによって設定されたプロパティ値がコンピューターの再起動後も保持される場合は、このパラメーターを PLUGPLAY_PROPERTY_PERSISTENT に設定します。 それ以外の場合は、Flags を 0 に設定します。

[in] Type

このパラメーターを、Data バッファーで指定されるデータの型を指定する DEVPROPTYPE 値に設定します。

[in] Size

データ が指すバッファーのサイズ バイト単位で指定します。

[in, optional] Data

デバイス インターフェイスのプロパティ データへのポインター。 指定したプロパティを削除するには、このパラメーター NULL に設定します。 データ が NULL以外の場合、ルーチンはプロパティ値の内部コピーを格納します。 Data が指すバッファーは、呼び出しが戻った後も有効なままである必要はありません。

戻り値

IoSetDeviceInterfacePropertyData は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 考えられるエラー戻り値には、次の状態コードが含まれます。

備考

カーネル モード ドライバーは、IoSetDeviceInterfacePropertyData ルーチンを使用して、統合デバイス プロパティ モデルの一部として定義されているデバイス インターフェイス プロパティを変更します。 デバイス インターフェイスのプロパティの詳細については、「デバイスのプロパティを参照してください。

ドライバーは、IoGetDeviceInterfacePropertyData ルーチンを使用して、デバイス インターフェイス プロパティの現在の値を取得できます。

IoSetDeviceInterfacePropertyData の呼び出し元は、システム スレッドのコンテキストで IRQL <= APC_LEVELで実行されている必要があります。

必要条件

関連項目

DEVPROPKEY を する

DEVPROPTYPE を する

IoGetDeviceInterfacePropertyData の