IMediaSeeking::CheckCapabilities メソッド (strmif.h)

  • [アーティクル]

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

CheckCapabilities メソッドは、ストリームでシーク機能が指定されているかどうかを照会します。

構文

HRESULT CheckCapabilities(
  [in, out] DWORD *pCapabilities
);

パラメーター

[in, out] pCapabilities

入力時に、1 つ以上のAM_SEEKING_SEEKING_CAPABILITIES属性のビットごとの OR を含む変数へのポインター。 メソッドから制御が戻るときに、これらの属性のうち使用可能な属性が値によって示されます。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_FALSE
 pCapabilities の一部の機能が存在するわけではありません。
S_OK
 pCapabilities のすべての機能が存在します。
E_FAIL
 pCapabilities に機能はありません。
E_POINTER
 NULL ポインター引数。

注釈

いくつかの特定の機能にのみ関心がある場合は、このメソッドを呼び出す方が、すべてのストリームのシーク機能をチェックする IMediaSeeking::GetCapabilities を呼び出すよりも効率的です。

このメソッドを呼び出すには、DWORD 変数を宣言し、テストするAM_SEEKING_SEEKING_CAPABILITIES フラグのビットごとの OR の組み合わせに値を設定します。 pCapabilities パラメーターにこの値のアドレスを渡します。 メソッドが戻ると、 pCapabilities には元のビットのサブセットが含まれており、どの機能が存在するかを示します。 戻り値は、要求された機能の一部、なし、またはすべてが存在するかどうかを示します。

次のコード例は、ストリームが前方シーク、後方シーク、絶対シークをサポートしているかどうかを確認する方法を示しています。

C++ 
チェックする機能のフラグを設定します。

DWORD dwCaps = AM_SEEKING_CanSeekAbsolute |AM_SEEKING_CanSeekForwards |AM_SEEKING_CanSeekBackwards;


HRESULT hr = pMediaSeeking-CheckCapabilities>(&dwCaps); if(FAILED(hr)) { // ストリームをシークできません。
} else if (hr == S_OK) {

// The stream can seek forward, backward, and to an absolute position.
}
else if (hr == S_FALSE) // The stream has some of the capabilities.
{
if (dwCaps & AM_SEEKING_CanSeekAbsolute)
{
// The stream can seek to an absolute position.
}
if (dwCaps & AM_SEEKING_CanSeekForwards)
{
// The stream can seek forward.
}
if (dwCaps & AM_SEEKING_CanSeekBackwards)
{
// The stream can seek backward.
}
}

要件

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

こちらもご覧ください

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

IMediaSeeking インターフェイス