IWMDMDevice3::SetProperty メソッド (mswmdm.h)

[アーティクル]
03/05/2024

SetProperty メソッドは、書き込み可能な場合は、特定のデバイスプロパティを設定します。

構文

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

パラメーター

[in] pwszPropName

設定するプロパティのワイド文字の null で終わる文字列名。これにより、同じ名前の既存のプロパティが上書きされます。アプリケーションがこの呼び出しを行うと、 PropVariantClear を使用して動的メモリを解放する必要があります。標準プロパティ名定数の一覧は、メタデータ定数で指定します。

[in] pValue

設定されているプロパティの値。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

このメソッドは、指定されたデバイスプロパティを設定します。サポートされているデバイスプロパティの一覧を取得するには、クライアントは IWMDMDevice3::GetProperty メソッドに 対して g_wszWMDMSupportedDeviceProperties プロパティのクエリを実行する必要があります。

デバイスプロパティ名の一覧については、「メタデータ定数」を参照してください。

このメソッドは、ストレージの SetMetadata メソッドに似ていますが、このメソッドは一度に 1 つのプロパティのみを設定できます。

デバイスのすべてのプロパティを設定できるわけではありません。