Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

MFRegisterLocalSchemeHandler function

Registers a scheme handler in the caller's process.

Syntax


HRESULT MFRegisterLocalSchemeHandler(
  _In_  PCWSTR szScheme,
  _In_  IMFActivate *pActivate
);

Parameters

szScheme [in]

A string that contains the scheme. The scheme includes the trailing ':' character; for example, "http:".

pActivate [in]

A pointer to the IMFActivate interface of an activation object. The caller implements this interface. The IMFActivate::ActivateObject method of the activation object must create a scheme handler object. The scheme handler exposes the IMFSchemeHandler interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Scheme handlers are used in Microsoft Media Foundation during the source resolution process, which creates a media source from a URL. For more information, see Scheme Handlers and Byte-Stream Handlers.

Within a process, local scheme handlers take precedence over scheme handlers that are registered in the registry. Local scheme handlers are not visible to other processes.

Use this function if you want to register a custom scheme handler for your application, but do not want the handler available to other applications.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Mfapi.h

DLL

Mfplat.lib

See also

Scheme Handlers and Byte-Stream Handlers
MFRegisterLocalByteStreamHandler

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.