IAMExtTransport::p ut_MediaState メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
メソッドは put_MediaState
、メディアの現在の状態を設定します。
構文
HRESULT put_MediaState(
[in] long State
);
パラメーター
[in] State
メディアの状態を 長整数 として指定します。 次のいずれかを使用します:
値 | 説明 |
---|---|
ED_MEDIA_SPIN_DOWN | ディスク メディアの場合: スピンを停止します。 テープ メディアの場合: テープの読み取りを解除します。 |
ED_MEDIA_SPIN_UP | ディスク メディアの場合: スピンを開始します。 テープ メディアの場合: テープをスレッド処理します。 |
ED_MEDIA_UNLOAD | ドライブからメディアを取り出します。 |
これらの定数は、ディスクメディアとテープメディア用です。 他のデバイスでは、新しい定数を定義する必要がある場合があります。
戻り値
このメソッドが成功すると、S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | strmif.h (Dshow.h を含む) |
Library | Strmiids.lib |