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

[アーティクル]
07/28/2023

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

メソッドは GetStatus 、トランスポートの状態に関する情報を返します。

構文

HRESULT GetStatus(
  [in]      long StatusItem,
  [in, out] long *pValue
);

パラメーター

[in] StatusItem

取得する状態情報を指定します。詳細については、「解説」を参照してください。

[in, out] pValue

長整数を指定または受け取る変数へのポインター。その意味は StatusItem の値に依存します。詳細については、「解説」を参照してください。

戻り値

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

注釈

StatusItem パラメーターは、取得する状態情報を指定するフラグです。メソッドは 、pValue パラメーターの情報を返します。すべてのデバイスですべての状態フラグがサポートされているわけではありません。次のフラグが定義されています。

ED_MODE: 一時停止や再生など、現在のトランスポートモードを返します。トランスポートモードを定義する定数の一覧については、「 IAMExtTransport::p ut_Mode 」を参照してください。別の方法として、 StatusItem をこれらの定数のいずれかに設定できます。トランスポートが現在そのモードの場合は pValue が値 OATRUE を受け取り、それ以外の場合は OAFALSE を受け取ります。

ED_MEDIA_TYPE: このトランスポートのメディアの形式を示します。次のいずれかの定数を返します。

常時	説明
ED_MEDIA_VHS	Vhs
ED_MEDIA_SVHS	S-VHS
ED_MEDIA_HI8	Hi-8
ED_MEDIA_UMATIC	Umatic
ED_MEDIA_DVC	DV テープ (DVC)
ED_MEDIA_1_INCH	1インチテープ
ED_MEDIA_D1	D1 形式
ED_MEDIA_D2	D2 形式
ED_MEDIA_D3	D3 形式
ED_MEDIA_D5	D5 形式
ED_MEDIA_DBETA	Digital Betacam
ED_MEDIA_BETA	Betacam
ED_MEDIA_8MM	8 ミリメートル
ED_MEDIA_DDR	デジタルディスクレコーダー
ED_MEDIA_SX	Betacam SX
ED_MEDIA_OTHER	その他
ED_MEDIA_CLV	CLV (一定の線形速度、または "標準再生") レーザーディスク
ED_MEDIA_CAV	CAV (一定Angular速度、または "拡張再生") レーザーディスク

ED_LINK_MODE: トランスポートのコントロールがフィルターグラフの Run、 Stop、 Pause メソッドにリンクされている場合は OATRUE を返し、それ以外の場合は OAFALSE を返します。詳細については、「 IAMExtTransport::p ut_Mode 」を参照してください。
ED_MEDIA_PRESENT: トランスポートのメディアが存在する場合は OATRUE を返し、それ以外の場合は OAFALSE を返します。
ED_MEDIA_LENGTH: メディアの長さを現在の時刻形式の単位で返します ( 「IAMExtTransport::SetTransportBasicParameters」を参照)。
ED_MEDIA_TRACK_COUNT: トラック数を返します。
ED_MEDIA_TRACK_LENGTH: 現在の時刻形式の単位でトラックの長さを返します。
ED_MEDIA_SIDE: メディアのどの側がアクティブであるかを示します。

Windows XP Service Pack 2 以降では、ED_MODEに対して次の追加の再生モードが定義されています。

常時	説明
ED_MODE_PLAY_SLOW_FWD_X	未指定のスローフォワードを再生します。 (ベンダー固有の速度での低速再生)。
ED_MODE_PLAY_FAST_FWD_X	未指定の早送りを再生します。 (ベンダー固有の速度で早送り再生)。
ED_MODE_PLAY_SLOW_REV_X	指定されていない遅い逆を再生します。 (ベンダー固有の速度での低速反転再生)。
ED_MODE_PLAY_FAST_REV_X	未指定の高速反転を再生します。 (ベンダー固有の速度で高速反転再生)。
ED_MODE_STOP_START	トランスポートは、テープ (またはその他のトランスポートメディア) の先頭で停止されます。
ED_MODE_STOP_END	トランスポートは、テープの末尾 (またはその他のトランスポートメディア) で停止されます。
ED_MODE_STOP_EMERGENCY	予期しない状態のため、またはトランスポートの損傷を回避するために、トランスポートが停止しました。

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

DV の実装

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

ED_MODE: 前の解説を参照してください。
ED_MEDIA_TYPE: 次のいずれかの値を返します。

常時説明

ED_MEDIA_VHS VHS テープ。

ED_MEDIA_DVC DV テープ。

ED_MEDIA_UNKNOWN 不明な型です。

ED_MEDIA_NOT_PRESENT トランスポートが空です。
ED_DEV_REMOVED_HEVENT_GET。イベントへのハンドルを返します。デバイスがシステムから物理的に削除された場合、ドライバーはイベントを通知します。
ED_DEV_REMOVED_HEVENT_RELEASE。 ED_DEV_REMOVED_HEVENT_GET フラグを使用して取得したイベントハンドルを解放します。 pValue パラメーターでハンドルのアドレスを指定します。
ED_MODE_CHANGE_NOTIFY。 pValue のデバイスの状態を返します。メソッドが E_PENDINGを返す場合、状態の変更は保留中です。 ED_NOTIFY_HEVENT_GET フラグを使用すると、状態の変更が完了したときに通知を受け取ることができます。
ED_NOTIFY_HEVENT_GET。イベントへのハンドルを返します。ドライバーは、デバイスがモードの変更を完了したときにイベントを通知します。
ED_NOTIFY_HEVENT_RELEASE。 ED_NOTIFY_HEVENT_GET フラグを使用して取得したイベントハンドルを解放します。 pValue パラメーターでハンドルのアドレスを指定します。

常時	説明
ED_MEDIA_VHS	VHS テープ。
ED_MEDIA_DVC	DV テープ。
ED_MEDIA_UNKNOWN	不明な型です。
ED_MEDIA_NOT_PRESENT	トランスポートが空です。

MPEG ビデオカメラの実装

MSTape では、ED_MEDIA_TYPE フラグの追加のメディア形式がサポートされています。

常時	説明
ED_MEDIA_NEO	MPEG-2 トランスポートストリーム (D-VHS) 用のミニデジタルテープ。

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

要件

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

こちらもご覧ください

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

IAMExtTransport インターフェイス

次の方法で共有