MFRegisterLocalByteStreamHandler 関数 (mfapi.h)

呼び出し元のプロセスにバイト ストリーム ハンドラーを登録します。

構文

HRESULT MFRegisterLocalByteStreamHandler(
  [in] PCWSTR      szFileExtension,
  [in] PCWSTR      szMimeType,
  [in] IMFActivate *pActivate
);

パラメーター

[in] szFileExtension

このハンドラーのファイル名拡張子を含む文字列。

[in] szMimeType

このハンドラーの MIME の種類を含む文字列。

[in] pActivate

アクティブ化オブジェクトの IMFActivate インターフェイスへのポインター。 呼び出し元はこのインターフェイスを実装します。 アクティブ化オブジェクトの IMFActivate::ActivateObject メソッドは、バイト ストリーム ハンドラーを作成する必要があります。 バイト ストリーム ハンドラーは、 IMFByteStreamHandler インターフェイスを 公開します。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

バイト ストリーム ハンドラーは、ソース解決プロセス中に Microsoft Media Foundation で使用され、URL からメディア ソースが作成されます。 詳細については、「 スキーム ハンドラー」と「Byte-Stream ハンドラー」を参照してください。

プロセス内では、ローカル バイト ストリーム ハンドラーは、レジストリに登録されているバイト ストリーム ハンドラーよりも優先されます。 ローカル バイト ストリーム ハンドラーは、他のプロセスからは参照できません。

アプリケーションのカスタム バイト ストリーム ハンドラーを登録するが、そのハンドラーを他のアプリケーションで使用したくない場合は、この関数を使用します。

szFileExtension または szMimeType は NULL にすることができます。少なくとも 1 つは NULL 以外である必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfapi.h
Library	Mfplat.lib
[DLL]	Mfplat.dll

こちらもご覧ください

メディア ファンデーション機能

スキーム ハンドラーと Byte-Stream ハンドラー