Función MFRegisterLocalByteStreamHandler (mfapi.h)

  • Artículo

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

Sintaxis

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

Parámetros

[in] szFileExtension

Cadena que contiene la extensión de nombre de archivo para este controlador.

[in] szMimeType

Cadena que contiene el tipo MIME para este controlador.

[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 controlador de secuencia de bytes. El controlador de flujo de bytes expone la interfaz IMFByteStreamHandler .

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 secuencias de bytes 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 secuencia de bytes locales tienen prioridad sobre los controladores de secuencia de bytes registrados en el registro. Los controladores de secuencia de bytes locales no son visibles para otros procesos.

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

szFileExtension o szMimeType pueden ser NULL; al menos uno debe ser distinto de NULL.

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

Funciones de Media Foundation

Controladores de esquema y controladores de Byte-Stream