Función MFRegisterLocalSchemeHandler (mfapi.h)

  • Artículo

Registra un controlador de esquema en el proceso del autor de la llamada.

Sintaxis

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

Parámetros

[in] szScheme

Cadena que contiene el esquema. El esquema incluye el carácter final ':'; por ejemplo, "http:".

[in] pActivate

Puntero a la interfaz IMFActivate de un objeto de activación. El autor de la llamada implementa esta interfaz. El método IMFActivate::ActivateObject del objeto de activación debe crear un objeto de controlador de esquema. El controlador de esquema expone la interfaz IMFSchemeHandler .

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Los controladores de esquema se usan en Microsoft Media Foundation durante el proceso de resolución de origen, que crea un origen multimedia a partir de una dirección URL. Para obtener más información, vea Controladores de esquema y controladores de Byte-Stream.

Dentro de un proceso, los controladores de esquema local tienen prioridad sobre los controladores de esquema que están registrados en el registro. Los controladores de esquema local no son visibles para otros procesos.

Use esta función si desea registrar un controlador de esquema personalizado para la aplicación, pero no quiere que el controlador esté disponible para otras aplicaciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfapi.h
Library Mfplat.lib
Archivo DLL Mfplat.dll

Consulte también

MFRegisterLocalByteStreamHandler

Funciones de Media Foundation

Controladores de esquema y controladores de Byte-Stream