次の方法で共有

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

  • [アーティクル]

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

メソッドは GetTransportBasicParameters 、外部トランスポートの一般的なプロパティを取得します。

構文

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

パラメーター

[in] Param

受信するプロパティを指定します。

[in, out] pValue

長整数を受け取る変数へのポインター。 詳細については、「解説」を参照してください。

[in, out] ppszData

文字列を受け取る LPOLESTR 型の変数へのポインター。 詳細については、「解説」を参照してください。

戻り値

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

注釈

Param パラメーターは、取得するプロパティを指定するフラグです。 一部のプロパティは数値です。これらは pValue パラメーターで返されます。 その他のプロパティは文字列値です。これらは ppszData パラメーターで返されます。 フラグと予想される値の一覧については、「 IAMExtTransport::SetTransportBasicParameters」を参照してください。

メソッドが文字列を返す場合、呼び出し元は CoTaskMemFree 関数を使用して文字列を解放する必要があります。

DV および MPEG ビデオカメラの実装

MSDV では 、次の追加フラグがサポートされています。

  • ED_RAW_EXT_DEV_CMD: 生の AV/C コマンドを呼び出します。 ppszData パラメーターで、AV/C コマンドをバイト配列として指定します。 pValue パラメーターで、コマンドのサイズをバイト単位で指定します。 メソッドから制御が戻ると、 ppszData にはデバイスからの応答が含まれており、 pValue には応答のサイズ (バイト単位) が含まれます。 AV/C コマンドは、検証やエラー チェックなしでデバイスに直接渡されます。

    応答ペイロードが コマンドよりも大きい場合があります。 応答用のバッファーに十分な領域を割り当てるのは呼び出し元の責任です。 最大ペイロード サイズは 512 バイトです。

    詳細については、「 生 AV/C コマンドの発行」を参照してください。

  • ED_TRANSBASIC_INPUT_SIGNAL: DV ビデオカメラが受け入れるように設計されている信号形式を取得します。 pValue で次のいずれかの定数を返します。
    常時 説明
    ED_TRANSBASIC_SIGNAL_525_60_SD NTSC SD シグナル。
    ED_TRANSBASIC_SIGNAL_525_60_SDL NTSC SDL (ロングプレイ) 信号。
    ED_TRANSBASIC_SIGNAL_625_50_SD PAL SD 信号。
    ED_TRANSBASIC_SIGNAL_625_50_SDL PAL SDL (ロングプレイ) 信号。
    ED_TRANSBASIC_SIGNAL_MPEG2TS D-VHS シグナル。
     
  • ED_TRANSBASIC_OUTPUT_SIGNAL: DVビデオカメラが送信するように設計されている信号形式を取得します。 ED_TRANSBASIC_INPUT_SIGNAL フラグに一覧表示されている定数のいずれかを返します。

MSTape では、ED_TRANSBASIC_INPUT_SIGNALとED_TRANSBASIC_OUTPUT_SIGNALの追加の値がサポートされています。

常時 説明
ED_TRANSBASIC_SIGNAL_2500_60_MPEG 25 Mbps/60 MPEG ストリーム。
ED_TRANSBASIC_SIGNAL_1250_60_MPEG 12.5 Mbps/60 MPEG ストリーム。
ED_TRANSBASIC_SIGNAL_0625_60_MPEG 6.25 Mbps/60 MPEG ストリーム。
ED_TRANSBASIC_SIGNAL_2500_50_MPEG 25 Mbps/50 MPEG ストリーム。
ED_TRANSBASIC_SIGNAL_1250_50_MPEG 12.5 Mbps/50 MPEG ストリーム。
ED_TRANSBASIC_SIGNAL_0625_50_MPEG 6.25 Mbps/50 MPEG ストリーム。
ED_TRANSBASIC_SIGNAL_UNKNOWN 不明なシグナル形式。
 

これらのフラグは、ヘッダー ファイル Xprtdefs.h で定義されています。

Windows XP Service Pack 2 以降では、ED_TRANSBASIC_INPUT_SIGNALフラグと ED_TRANSBASIC_OUTPUT_SIGNAL フラグに対して次のシグナルの種類が定義されています。

常時 説明
ED_TRANSBASIC_SIGNAL_525_60_DV25 DVCPRO 25、525-60。
ED_TRANSBASIC_SIGNAL_625_50_DV25 DVCPRO 25、625-50。
ED_TRANSBASIC_SIGNAL_525_60_DV50 DVCPRO 50、525-60。
ED_TRANSBASIC_SIGNAL_625_50_DV50 DVCPRO 50、625-50。
ED_TRANSBASIC_SIGNAL_HD_60_DVH1 DVCPRO 100、1080i、または 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1 DVCPRO 100、1080i のみ
 

これらの定数を使用するには、Windows SDKのヘッダー ファイル Xprtdefs.h を含めます。

要件

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

こちらもご覧ください

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

IAMExtTransport インターフェイス