IPropertySetter::GetProps メソッド

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

注意

[非推奨。 この API は、Windows の今後のリリースから削除される可能性があります。]

 

メソッドは GetProps 、対応する値を使用して、このオブジェクトに設定されたプロパティを取得します。

構文

HRESULT GetProps(
  [out] LONG         *pcParams,
  [out] DEXTER_PARAM **paParam,
  [out] DEXTER_VALUE **paValue
);

パラメーター

pcParams [out]

paParam で返される構造体の数を受け取ります。

paParam [out]

DEXTER_PARAM構造体の配列へのポインターのアドレス。

paValue [out]

DEXTER_VALUE構造体の配列へのポインターのアドレス。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

paParam で返される各プロパティについて、nValues メンバーは、プロパティに関連付けられているDEXTER_VALUE構造体の数を示します。 ペアは、各プロパティの昇順で返されます。

返された構造体の使用が完了したら、 IPropertySetter::FreeProps を呼び出して、このメソッドによって割り当てられたリソースを解放します。

注意

ヘッダー ファイル Qedit.h は、バージョン 7 より後の Direct3D ヘッダーと互換性がありません。

 

注意

Qedit.h を取得するには、Windows Vista および .NET Framework 3.0 用の Microsoft Windows SDK Update をダウンロードします。 Qedit.h は、Windows 7 および .NET Framework 3.5 Service Pack 1 のMicrosoft Windows SDKでは使用できません。

 

例

次のコード例は、プロパティ セッターのインスタンス上のすべての値を反復処理する方法を示しています。

IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).

DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;

hr = pSetter->GetProps(&count, &pParam, &pValue);

LONG num = 0;
for (LONG i = 0; i < count; i++)
{
    for (LONG j = 0; j < pParam[i].nValues; j++)
    {
        // pValue[num] is the next value in the sequence for pParam[i]
    }
    num += pParam[i].nValues;
}

要件

要件 値
ヘッダー
Qedit.h
ライブラリ
Strmiids.lib

関連項目

IPropertySetter インターフェイス

エラーコードと成功コード