次の方法で共有

IAMExtTransport::GetStatus

  • [アーティクル]

GetStatus メソッドは、駆動デバイスの状態に関する情報を返す。

構文

  HRESULT GetStatus(
  long StatusItem,
  long *pValue
);

パラメータ

StatusItem

[in]  取得する状態情報を指定する。詳細については、「注意」を参照すること。

pValue

[out]  StatusItem の値によって意味が異なる long 型の整数値を指定または受け取る変数へのポインタ。詳細については、「注意」を参照すること。

戻り値

メソッドが成功すると、戻り値は S_OK となる。それ以外の場合は HRESULT エラー コードを返す。

注意

StatusItem 引数は、取得する状態情報を指定するフラグである。このメソッドは、pValue 引数の情報に返される。すべてのデバイスがすべての状態フラグをサポートするわけではない。次のフラグが定義されている。

  • ED_MODE: ポーズや再生といった、現在の駆動デバイス モードを返す。駆動デバイス モードを定義する定数のリストについては、「IAMExtTransport::put_Mode」を参照すること。または、StatusItem をそれらの定数の 1 つと同じに設定すると、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 デジタル ベータカム
    ED_MEDIA_BETA ベータカム
    ED_MEDIA_8MM 8 ミリ
    ED_MEDIA_DDR デジタル ディスク レコーダ
    ED_MEDIA_SX ベータカム SX
    ED_MEDIA_OTHER その他
    ED_MEDIA_CLV CLV (Constant Linear Velocity または "標準再生") レーザーディスク
    ED_MEDIA_CAV CAV (Constant Angular Velocity または "拡張再生") レーザーディスク

  • ED_LINK_MODE: 駆動デバイスのコントロールがフィルタ グラフの Run、Stop、Pause メソッドにリンクされている場合は OATRUE を返し、それ以外の場合は OAFALSE を返す。詳細については、「IAMExtTransport::put_Mode」を参照すること。

  • ED_MEDIA_PRESENT: 駆動デバイスのメディアがある場合は OATRUE を返し、それ以外の場合は OAFALSE を返す。

  • ED_MEDIA_LENGTH: メディアの長さを、現在のタイム フォーマットの単位で返す (「IAMExtTransport::SetTransportBasicParameters」を参照)。

  • ED_MEDIA_TRACK_COUNT: トラック カウントを返す。

  • ED_MEDIA_TRACK_LENGTH: トラックの長さを、現在のタイム フォーマットの単位で返す。

  • ED_MEDIA_SIDE: メディアのどちらの面がアクティブかを示す。

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 引数で指定する。

MPEG カムコーダの実装

MSTape は、ED_MEDIA_TYPE フラグの追加メディア フォーマットをサポートしている。

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

これらのフラグのいくつかは、ヘッダー ファイル Xptrdefs.h 内で定義される。

参照