Compartir a través de

Función MFTRegisterLocal (mfapi.h)

  • Artículo

Registra una transformación de Media Foundation (MFT) en el proceso del autor de la llamada.

Sintaxis

HRESULT MFTRegisterLocal(
  [in] IClassFactory                *pClassFactory,
  [in] REFGUID                      guidCategory,
  [in] LPCWSTR                      pszName,
  [in] UINT32                       Flags,
  [in] UINT32                       cInputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pInputTypes,
  [in] UINT32                       cOutputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pOutputTypes
);

Parámetros

[in] pClassFactory

Puntero a la interfaz IClassFactory de un objeto de generador de clases. El generador de clases crea el MFT.

[in] guidCategory

GUID que especifica la categoría del MFT. Para obtener una lista de las categorías de MFT, consulte MFT_CATEGORY.

[in] pszName

Cadena terminada en null de caracteres anchos que contiene el nombre descriptivo de MFT.

[in] Flags

OR bit a bit de cero o más marcas de la enumeración _MFT_ENUM_FLAG .

[in] cInputTypes

Número de elementos de la matriz pInputTypes .

[in] pInputTypes

Puntero a una matriz de estructuras de MFT_REGISTER_TYPE_INFO . Cada miembro de la matriz especifica un formato de entrada que admite MFT. Este parámetro puede ser NULL si cInputTypes es cero.

[in] cOutputTypes

Número de elementos de la matriz pOutputTypes .

[in] pOutputTypes

Puntero a una matriz de estructuras de MFT_REGISTER_TYPE_INFO . Cada miembro de la matriz define un formato de salida que admite MFT. Este parámetro puede ser NULL si cOutputTypes es cero.

Valor devuelto

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

Comentarios

El propósito principal de esta función es hacer que un MFT esté disponible para la resolución automática de topología sin hacer que MFT esté disponible para otros procesos o aplicaciones.

Después de llamar a esta función, MFT se puede enumerar llamando a la función MFTEnumEx con la marca MFT_ENUM_FLAG_LOCALMFT . El MFT se puede enumerar desde dentro del mismo proceso, pero no es visible para otros procesos.

El parámetro pClassFactory especifica un objeto de generador de clases que crea el MFT. El método IClassFactory::CreateInstance del generador de clases debe devolver un objeto que admita la interfaz IMFTransform .

Nota La función MFTEnumEx recupera una lista de punteros IMFActivate . Sin embargo, la fábrica de clases no necesita apoyar la interfaz IMFActivate . En su lugar, la función MFTEnumEx proporciona una implementación de IMFActivate que encapsula la fábrica de clases.
 
Para anular el registro del MFT del proceso actual, llame a MFTUnregisterLocal.

Si necesita registrar un MFT en el proceso de ruta de acceso a medios protegidos (PMP), use la interfaz IMFLocalMFTRegistration .

Requisitos

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

Consulte también

MFTRegisterLocalByCLSID

Funciones de Media Foundation