IMDSPDevice3::GetProperty メソッド (mswmdm.h)

GetProperty メソッドは、特定のデバイスプロパティを取得します。

構文

HRESULT GetProperty(
  [in]  LPCWSTR     pwszPropName,
  [out] PROPVARIANT *pValue
);

[in] pwszPropName

デバイスから取得されるプロパティの名前。

[out] pValue

プロパティの戻り値。

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

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

pValue が指すバリアントは空の PROPVARIANT に設定されます。つまり、その VT は VT_EMPTY に設定されます。

サービスプロバイダーは、このバリアントをプロパティ pwszPropName の適切なプロパティ値に設定する必要があります。

pwszPropName がg_wszWMDMSupportedDeviceProperties場合、サービスプロバイダーはサポートされているデバイスプロパティの配列を返す必要があります。このような場合は、バリアントの VT をVT_BSTRする必要があります |VT_ARRAY。

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

このメソッドは、ストレージの IMDSPStorage3::GetMetadata メソッドと IMDSPStorage4::GetSpecifiedMetadata メソッドに似ていますが、このメソッドは一度に 1 つのプロパティのみを取得できます。