次の方法で共有

IAMStreamSelect::Info メソッド (strmif.h)

  • [アーティクル]

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

メソッドは Info 、指定されたストリームに関する情報を取得します。

構文

HRESULT Info(
  [in]  long          lIndex,
  [out] AM_MEDIA_TYPE **ppmt,
  [out] DWORD         *pdwFlags,
  [out] LCID          *plcid,
  [out] DWORD         *pdwGroup,
  [out] LPWSTR        *ppszName,
  [out] IUnknown      **ppObject,
  [out] IUnknown      **ppUnk
);

パラメーター

[in] lIndex

ストリームの 0 から始まるインデックス。

[out] ppmt

ストリームのメディアの種類へのポインターを受け取る変数のアドレス。 このパラメーターは省略可能であり、 NULL にすることができます。 値が NULL 以外の場合、メソッドは AM_MEDIA_TYPE 構造体へのポインターを返します。 呼び出し元は、形式ブロックを含む構造体を削除する必要があります。 (DirectShow 基本クラス ライブラリから DeleteMediaType 関数を使用できます)。

[out] pdwFlags

次のいずれかの値を受け取る変数へのポインター。

値 説明
ゼロ このストリームは無効になっています。
AMSTREAMSELECTINFO_ENABLED ストリームが有効になっており、このグループ内の他のユーザーも有効になっている可能性があります。
AMSTREAMSELECTINFO_EXCLUSIVE このストリームは、グループ内で有効になっている唯一のストリームです。
 

このパラメーターは省略可能であり、 NULL にすることができます。

[out] plcid

ロケール コンテキスト (LCID) 値を受け取る変数へのポインター。 ストリームが特定のロケールに関連付けられている場合、LCID はこの変数で返されます。 それ以外の場合、変数は値 0 を受け取ります。 このパラメーターは省略可能であり、 NULL にすることができます。

[out] pdwGroup

ストリームが関連付けられている論理グループを受け取る変数へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。

[out] ppszName

ストリーム名へのポインターを受け取る変数のアドレス。 呼び出し元は 、CoTaskMemFree 関数を呼び出して、返される文字列を解放する必要があります。 このパラメーターは省略可能であり、 NULL にすることができます。

[out] ppObject

IUnknown インターフェイス ポインターを受け取る変数のアドレス。 メソッドは、ストリームに関連付けられたピンまたはフィルターへのポインターを返すか、 値 NULL を返す場合があります。 メソッドが NULL 以外の値を返す場合、呼び出し元は IUnknown ポインターを解放する必要があります。

IAMStreamSelect::Enable メソッドを呼び出すと、このメソッドによって返されるオブジェクトが無効になる可能性があります。

このパラメーターは省略可能であり、 NULL にすることができます。

MPEG-1 Stream Splitter、MPEG-2 Splitter、および SAMI (CC) パーサー フィルターは、選択したストリームに関連付けられているピンへのポインターを返します。

[out] ppUnk

IUnknown インターフェイス ポインターを受け取る変数のアドレス。 メソッドは、ストリームに固有のインターフェイスへのポインターを返すか、値 NULL を返す場合があります。 メソッドが NULL 以外の値を返す場合、呼び出し元は IUnknown ポインターを解放する必要があります。 このパラメーターは省略可能であり、 NULL にすることができます。

MPEG-1 Stream スプリッター、MPEG-2 スプリッター、および SAMI (CC) パーサー フィルターはすべて、値 NULL を返します。 サード パーティのフィルターは、カスタム フィルター インターフェイスへのポインターを返す場合があります。

戻り値

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

リターン コード 説明
E_FAIL
 失敗しました。
E_OUTOFMEMORY
 メモリ不足です。
S_FALSE
 インデックスが範囲外です。
S_OK
 正常終了しました。

要件

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

こちらもご覧ください

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

IAMStreamSelect インターフェイス