IAMStats::GetIndex メソッド (control.h)

  • [アーティクル]

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

メソッドは GetIndex 、名前付き統計のインデックスを取得するか、新しい統計を作成します。

構文

HRESULT GetIndex(
  [in]  BSTR szName,
  [in]  long lCreate,
  [out] long *plIndex
);

パラメーター

[in] szName

統計の名前を指定します。

[in] lCreate

統計がまだ定義されていない場合に統計を作成するかどうかを指定します。 値が TRUE の場合、メソッドは、その名前の既存のエントリが見つからないときに、統計の新しいインデックスを作成します。 値が FALSE の場合、統計がまだ存在しない場合、メソッドは失敗します。

[out] plIndex

インデックスを受け取ります。

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 この名前と一致しません。
E_POINTER
 NULL ポインター引数。

要件

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

こちらもご覧ください

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

IAMStats インターフェイス