Interfaz IMFPluginControl (mfobjects.h)

  • Artículo

Controla cómo se enumeran los orígenes multimedia y las transformaciones en Microsoft Media Foundation.

Para obtener un puntero a esta interfaz, llame a MFGetPluginControl.

Herencia

La interfaz IMFPluginControl hereda de la interfaz IUnknown . IMFPluginControl también tiene estos tipos de miembros:

Métodos

La interfaz IMFPluginControl tiene estos métodos.

 
IMFPluginControl::GetDisabledByIndex

IMFPluginControl::GetDisabledByIndex (mfobjects.h) obtiene un identificador de clase (CLSID) de la lista bloqueada.
IMFPluginControl::GetPreferredClsid

Busca en la lista preferida un identificador de clase (CLSID) que coincida con un nombre de clave especificado.
IMFPluginControl::GetPreferredClsidByIndex

El método IMFPluginControl::GetPreferredClsidByIndex (mfobjects.h) obtiene un identificador de clase (CLSID) de la lista preferida, especificada por el valor de índice.
IMFPluginControl::IsDisabled

Consulta si un identificador de clase (CLSID) aparece en la lista bloqueada. (IMFPluginControl.IsDisabled)
IMFPluginControl::SetDisabled

Agrega un identificador de clase (CLSID) a la lista de bloqueados o quita un CLSID de la lista. (IMFPluginControl.SetDisabled)
IMFPluginControl::SetPreferredClsid

Agrega un identificador de clase (CLSID) a la lista preferida o quita un CLSID de la lista. (IMFPluginControl.SetPreferredClsid)

Comentarios

Media Foundation proporciona un conjunto de orígenes y descodificadores multimedia integrados. Las aplicaciones pueden enumerarlas de la siguiente manera:

  • Los orígenes multimedia se enumeran a través del Solucionador de origen.
  • Las transformaciones, como los descodificadores, se enumeran a través de las funciones MFTEnum y MFTEnumEx .
Las aplicaciones también pueden enumerar estos objetos indirectamente. Por ejemplo, si una aplicación usa el cargador de topologías para resolver una topología parcial, el cargador de topología llama a MFTEnumEx para buscar los descodificadores necesarios.

Los terceros pueden implementar sus propios orígenes de medios personalizados y descodificadores, y registrarlos para su enumeración para que otras aplicaciones puedan usarlas.

Para controlar el orden de enumeración, Media Foundation mantiene dos listas de CLSID para todo el proceso: una lista preferida y una lista bloqueada. Un objeto cuyo CLSID aparece en la lista preferida aparece primero en el orden de enumeración. No se enumera un objeto cuyo CLSID aparece en la lista bloqueada.

Las listas se rellenan inicialmente desde el registro. Las aplicaciones pueden usar la interfaz IMFPluginControl para modificar las listas del proceso actual.

La lista preferida contiene un conjunto de pares clave-valor, donde las claves son cadenas y los valores son CLSID. Estos pares clave-valor se definen de la siguiente manera:

  • En el caso de los orígenes multimedia, el nombre de clave es una extensión de nombre de archivo, un esquema de protocolo o un tipo MIME. El valor es el CLSID de un controlador de esquema o un controlador de flujo de bytes para ese origen multimedia.
  • En el caso de los descodificadores, el nombre de clave es un GUID de subtipo multimedia en forma de cadena canónica. (Para obtener más información sobre los subtipos multimedia, vea Tipos de medios). El valor es el CLSID de la transformación de Media Foundation (MFT) que implementa el descodificador.
En los ejemplos siguientes se muestran los distintos tipos de clave:
  • Extensión de archivo: ".wmv"
  • Esquema: "http:"
  • Tipo MIME: "video/mp4"
  • Subtipo multimedia: "{47504A4D-0000-0010-8000-00AA00389B71}"
Para buscar la lista preferida por nombre de clave, llame al método IMFPluginControl::GetPreferredClsid . Para enumerar toda la lista, llame al método IMFPluginControl::GetPreferredClsidByIndex en un bucle.

La lista bloqueada contiene una lista de CLSID. Para enumerar toda la lista, llame al método IMFPluginControl::GetDisabledByIndex en un bucle. Para comprobar si aparece un CLSID específico en la lista, llame al método IMFPluginControl::IsDisabled .

Requisitos

   
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 mfobjects.h (include Mfidl.h)

Consulte también

MFGetPluginControl

Interfaces de Media Foundation