SwDeviceInterfacePropertySet 関数 (swdevice.h)

ソフトウェア デバイス インターフェイスのプロパティを設定します。

構文

HRESULT SwDeviceInterfacePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] PCWSTR            pszDeviceInterfaceId,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

パラメーター

[in] hSwDevice

プロパティを設定するインターフェイスのソフトウェア デバイスに対する HSWDEVICE ハンドル。

[in] pszDeviceInterfaceId

プロパティを設定するインターフェイスを識別する文字列。

[in] cPropertyCount

pProperties 配列内の DEVPROPERTY 構造体の数。

[in] pProperties

インターフェイスで設定するプロパティを含む DEVPROPERTY 構造体の配列。

戻り値

swDeviceInterfacePropertySet がインターフェイスのプロパティを正常に設定した場合、S_OKが返されます。それ以外の場合は、適切なエラー値。

注釈

SwDeviceInterfacePropertySet は、オペレーティング システムがクライアント アプリの SW_DEVICE_CREATE_CALLBACK コールバック関数を呼び出して、デバイス列挙が完了したことをクライアント アプリに通知した後にのみ呼び出すことができます。

SwDeviceInterfaceRegister 呼び出しの一部として設定されるプロパティと、SwDeviceInterfacePropertySet を呼び出すことによって後で設定されるプロパティには微妙な違いがあります。 SwDeviceInterfaceRegister の一部として設定されたプロパティはメモリに格納されます。デバイスがアンインストールされている場合、または null ドライバーがプロパティ ストアをワイプアウトした場合、PnP がデバイスを再列挙すると、これらのプロパティはソフトウェア デバイス API 機能によって再び書き込まれます。 これはすべてクライアントに対して透過的です。 列挙後に SwDeviceInterfacePropertySet を 使用して設定されたプロパティは、メモリ内に保持されません。 ただし、 SwDeviceInterfaceRegister を使用してプロパティを設定した場合は、 SwDeviceInterfacePropertySet で値を更新できます。この更新はメモリ内の値と永続化されたストアに適用されます。

SwDeviceInterfacePropertySet は、インターフェイスのオペレーティング システム ストアのプロパティを設定する場合にのみ使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	ユニバーサル
Header	swdevice.h
Library	Swdevice.lib;Windows 10の OneCoreUAP.lib
[DLL]	Cfgmgr32.dll