IMFSinkWriter::GetServiceForStream メソッド (mfreadwrite.h)

基になるメディア シンクまたはエンコーダーに対してインターフェイスのクエリを実行します。

構文

HRESULT GetServiceForStream(
  [in]  DWORD   dwStreamIndex,
  [in]  REFGUID guidService,
  [in]  REFIID  riid,
  [out] LPVOID  *ppvObject
);

パラメーター

[in] dwStreamIndex

クエリを実行するストリームの 0 から始まるインデックス。メディア シンク自体に対してクエリを実行するために MF_SINK_WRITER_MEDIASINK 。

[in] guidService

サービス識別子 GUID、または GUID_NULL。 値が GUID_NULLの場合、メソッドは QueryInterface を 呼び出して要求されたインターフェイスを取得します。 それ以外の場合、メソッドは IMFGetService::GetService を呼び出します。 サービス識別子の一覧については、「 サービス インターフェイス」を参照してください。

[in] riid

要求されているインターフェイスのインターフェイス識別子 (IID)。

[out] ppvObject

要求されたインターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

dwStreamIndex パラメーターが MF_SINK_WRITER_MEDIASINKと等しい場合、メソッドはメディア シンクからインターフェイスを取得しようとします。 それ以外の場合は、指定したインデックス位置にあるストリームのエンコーダーからインターフェイスを取得しようとします。 失敗した場合、またはエンコーダーが存在しない場合、メソッドはメディア シンク上のストリームからインターフェイスを取得しようとします。

シンクの入力と出力の種類が同じで圧縮されている場合は、エンコードが不要で、ビデオ エンコーダーがインスタンス化されない可能性があります。 その場合、 GetServiceForStream はMF_E_UNSUPPORTED_SERVICEを返します。

このインターフェイスは、Windows Vista のプラットフォーム更新プログラムの補足情報がインストールされている場合、Windows Vista で使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 用 Windows 7、Windows Vista およびプラットフォーム更新プログラムの補足 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfreadwrite.h

こちらもご覧ください

IMFSinkWriter

シンク ライター