次の方法で共有

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