次の方法で共有

IPropertySetter::CloneProps メソッド

  • [アーティクル]

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

注意

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

 

メソッドは CloneProps 、このプロパティ セッターから一連のプロパティを複製し、新しいプロパティ セッターに追加します。

構文

HRESULT CloneProps(
  [out] IPropertySetter **ppSetter,
  [in]  REFERENCE_TIME  rtStart,
  [in]  REFERENCE_TIME  rtStop
);

パラメーター

ppSetter [out]

新しいプロパティ セッターの IPropertySetter インターフェイスへのポインターを受け取ります。

rtStart [in]

複製する値の範囲の開始時刻 (100 ナノ秒単位)。

rtStop [in]

予約済み。

戻り値

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

解説

指定した開始時刻より後の値のみが複製されます。 その後、複製された値の時間が開始時刻を基準に調整されます。 たとえば、 rtStart が 20000000 (2 秒) の場合、時刻 300000000 の値 (3 秒) は、時刻 100000000 (1 秒) で複製されます。 最後に、複製された各プロパティには、開始時の元のプロパティの値と等しい初期値が与えられます (必要に応じて正しく補間されます)。 実際には、プロパティ データは、指定した開始時刻に分割されます。

メソッドが成功した場合、返される IPropertySetter インターフェイスには未処理の参照カウントがあります。 インターフェイスの使用が完了したら、必ずインターフェイスを解放してください。

注意

ヘッダー ファイル 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では使用できません。

 

要件

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

関連項目

IPropertySetter インターフェイス

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