IAMExtTransport::SetTransportBasicParameters メソッド (strmif.h)

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

メソッドは SetTransportBasicParameters 、トランスポートの一般的なプロパティを設定します。

構文

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

パラメーター

[in] Param

設定するプロパティを指定します。 詳細については、「解説」を参照してください。

[in] Value

プロパティの値を 長整数 として指定します。 詳細については、「解説」を参照してください。

[in] pszData

プロパティの値を LPOLESTR として指定します。 詳細については、「解説」を参照してください。

戻り値

このメソッドが成功すると、S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。 考えられるエラー コードは次のとおりです。

リターン コード	説明
E_NOTIMPL	デバイスでは、このプロパティの設定はサポートされていません。
ERROR_DEVICE_REMOVED	デバイスが削除されました。

注釈

Param パラメーターは、設定するプロパティを指定するフラグです。 一部のフラグでは、 プロパティは数値です。 Value パラメーターを使用して値を指定します。 その他のフラグの場合、 プロパティは文字列です。 pszData パラメーターを使用して値を指定します。 どちらの場合も、 メソッドはもう一方のパラメーターを無視します。

次のフラグの場合、 Value パラメーターは定義された定数を受け取ります。

• ED_TRANSBASIC_TIME_FORMAT: 時刻形式を指定します。

  常時	説明
  ED_FORMAT_MILLISECONDS	数ミリ秒です。
  ED_FORMAT_FRAMES	フレーム。
  ED_FORMAT_REFERENCE_TIME	参照時刻。
  ED_FORMAT_HMSF	時間、分、秒、フレームを表すバイナリ コード化された 10 進数。
  ED_FORMAT_TMSF	トラック、分、秒、フレームを表す 2 進コード 10 進数。

   
• ED_TRANSBASIC_TIME_REFERENCE: デバイスで使用される参照時間を指定します。

  常時	説明
  ED_TIMEREF_TIMECODE	時刻コード。
  ED_TIMEREF_CONTROL_TRACK	トラックを制御します。
  ED_TIMEREF_INDEX	Index :
  ED_TIMEREF_ATN	絶対トラック番号。 この定数は、ヘッダー ファイル Xprtdefs.h で定義されています。

   
• ED_TRANSBASIC_END_STOP_ACTION: デバイスがトランスポート メディアの末尾に達したときに実行するアクションを指定します。

  常時	説明
  ED_MODE_STOP	停止。
  ED_MODE_REWIND	巻き戻し。
  ED_MODE_FREEZE	固定/一時停止。

   
• ED_TRANSBASIC_RECORD_FORMAT: 記録速度を指定します。

  常時	説明
  ED_RECORD_FORMAT_SP	標準プレイ。
  ED_RECORD_FORMAT_LP	長い遊び。
  ED_RECORD_FORMAT_EP	拡張再生。

   
• ED_TRANSBASIC_SUPERIMPOSE: 画面上の表示を有効にするか無効にするかを指定します。

  常時	説明
  OATRUE	画面表示が有効になっています。
  OAFALSE	画面表示が無効になっています。

   
• ED_TRANSBASIC_STEP_UNIT: ステップ単位を指定します。

  常時	説明
  ED_STEP_FIELD	フィールド。
  ED_STEP_FRAME	フレーム。
  ED_STEP_3_2	3/2 プルダウン。

   
• ED_TRANSBASIC_SET_COUNTER_FORMAT: カウンターの時刻形式を設定します。 使用可能な値については、ED_TRANSBASIC_TIME_FORMAT フラグを参照してください。

次のフラグでは、 Value パラメーターに数値を使用します。

フラグ	説明
ED_TRANSBASIC_STEP_COUNT	ED_TRANSBASIC_STEP_UNIT フラグによって定義された単位で、ステップ数を指定します。
ED_TRANSBASIC_SET_FREEZE_TIMEOUT	固定モードのタイムアウトを現在の時刻形式の単位で指定します。
ED_TRANSBASIC_SETCLOCK	クロック時間を設定します。
ED_TRANSBASIC_SET_COUNTER_VALUE	カウンターの値を設定します。

 

次のフラグの場合は、 pszData パラメーターに文字列を使用します。

フラグ	説明
ED_TRANSBASIC_VOLUME_NAME	ボリューム名を指定します。

 

DV の実装

MSDV では、このメソッドはサポートされていません。 E_NOTIMPLを返します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	strmif.h (Dshow.h を含む)
Library	Strmiids.lib

こちらもご覧ください

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

IAMExtTransport インターフェイス

IAMExtTransport::GetTransportBasicParameters