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 |