MFRegisterLocalSchemeHandler 関数 (mfapi.h)

  • [アーティクル]

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

構文

HRESULT MFRegisterLocalSchemeHandler(
  [in] PCWSTR      szScheme,
  [in] IMFActivate *pActivate
);

パラメーター

[in] szScheme

スキームを含む文字列。 スキームには末尾の ':' 文字が含まれています。たとえば、"http:" です。

[in] pActivate

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

戻り値

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

注釈

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

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

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

要件

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

こちらもご覧ください

MFRegisterLocalByteStreamHandler

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

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