IAMExtTransport::SetEditPropertySet メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
メソッドは SetEditPropertySet
、編集プロパティのグループを記述する編集プロパティ セットを登録します。
このメソッドは実装されていません。
構文
HRESULT SetEditPropertySet(
[in, out] long *pEditID,
[in] long State
);
パラメーター
[in, out] pEditID
編集プロパティ セットの識別子を指定または受信する 長整数 へのポインター。
[in] State
編集プロパティ セットの状態を指定します。
値 | 説明 |
---|---|
ED_ACTIVE | 編集プロパティ セットをアクティブにします。 |
ED_DELETE | 編集プロパティ セットを削除します。 |
ED_INACTIVE | 編集プロパティ セットを無効にする。 |
ED_REGISTER | 編集プロパティ セットを登録します。 |
値がED_REGISTER場合、 pEditID パラメーターは edit プロパティ セットの識別子を受け取ります。 他のフラグの場合は、 pEditID パラメーターを使用して識別子を指定します。
戻り値
このメソッドが成功すると、S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。
注釈
編集イベントは、記録シーケンスを定義するパラメーターのセットです。 たとえば、パラメーターは編集モード、インポイントとアウトポイント、シーク位置を指定できます。 各編集イベントは、 編集プロパティと呼ばれる 1 つ以上のパラメーターで構成されます。 プロパティのコレクションは、 編集プロパティ セットと呼ばれます。 各編集プロパティ セットは、デバイス フィルターによって割り当てられた 長整数 で識別されます。
編集イベントを作成して実行するには、アプリケーションで次の操作を行う必要があります。
- 編集プロパティ セットを登録します。 State パラメーターに
SetEditPropertySet
ED_REGISTER値を指定して メソッドを呼び出します。 メソッドが戻ると、 pEditID パラメーターには edit プロパティ セットの識別子が含まれます。 この番号を使用して、後続のメソッド呼び出しで設定された編集プロパティを識別します。 - IAMExtTransport::SetEditProperty メソッドを使用して編集プロパティを指定します。
- ED_ACTIVE値を使用して を呼び出
SetEditPropertySet
して、編集イベントをアクティブ化します。 - ED_EDIT_SEEK値を使用して を呼び出
SetEditProperty
してトランスポートにキューを設定します。 - フィルター グラフを実行します。
C++ |
---|
編集プロパティ セット ID を登録します。 (メモリが割り当てられます。long EditId;SetEditPropertySet(&EditId, ED_REGISTER); |
DV の実装
MSDV では、このメソッドはサポートされていません。 E_NOTIMPLを返します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | strmif.h (Dshow.h を含む) |
Library | Strmiids.lib |