Función MFTRegisterLocalByCLSID (mfapi.h)

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

Sintaxis

HRESULT MFTRegisterLocalByCLSID(
  [in] REFCLSID                     clisdMFT,
  [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] clisdMFT

Identificador de clase (CLSID) del 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.

Para anular el registro del MFT del proceso actual, llame a MFTUnregisterLocalByCLSID.

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

MFTRegisterLocal

Funciones de Media Foundation