Interfaccia IMFPluginControl (mfobjects.h)

  • Articolo

Controlla la modalità di enumerazione delle origini multimediali e delle trasformazioni in Microsoft Media Foundation.

Per ottenere un puntatore a questa interfaccia, chiamare MFGetPluginControl.

Ereditarietà

L'interfaccia IMFPluginControl eredita dall'interfaccia IUnknown . IMFPluginControl ha anche questi tipi di membri:

Metodi

L'interfaccia IMFPluginControl ha questi metodi.

 
IMFPluginControl::GetDisabledByIndex

IMFPluginControl::GetDisabledByIndex (mfobjects.h) ottiene un identificatore di classe (CLSID) dall'elenco bloccato.
IMFPluginControl::GetPreferredClsid

Cerca nell'elenco preferito un identificatore di classe (CLSID) che corrisponde a un nome di chiave specificato.
IMFPluginControl::GetPreferredClsidByIndex

Il metodo IMFPluginControl::GetPreferredClsidByIndex (mfobjects.h) ottiene un identificatore di classe (CLSID) dall'elenco preferito, specificato dal valore di indice.
IMFPluginControl::IsDisabled

Esegue una query che indica se nell'elenco bloccato viene visualizzato un identificatore di classe (CLSID). (IMFPluginControl.IsDisabled)
IMFPluginControl::SetDisabled

Aggiunge un identificatore di classe (CLSID) all'elenco bloccato o rimuove un CLSID dall'elenco. (IMFPluginControl.SetDisabled)
IMFPluginControl::SetPreferredClsid

Aggiunge un identificatore di classe (CLSID) all'elenco preferito o rimuove un CLSID dall'elenco. (IMFPluginControl.SetPreferredClsid)

Commenti

Media Foundation offre un set di origini multimediali e decodificatori predefiniti. Le applicazioni possono enumerarle nel modo seguente:

Le applicazioni possono anche enumerare questi oggetti indirettamente. Ad esempio, se un'applicazione usa il caricatore della topologia per risolvere una topologia parziale, il caricatore della topologia chiama MFTEnumEx per trovare i decodificatori necessari.

Le terze parti possono implementare le proprie origini multimediali personalizzate e decodificatori e registrarle per l'enumerazione in modo che altre applicazioni possano usarle.

Per controllare l'ordine di enumerazione, Media Foundation gestisce due elenchi di CLSID a livello di processo: un elenco preferito e un elenco bloccato. Un oggetto il cui CLSID viene visualizzato nell'elenco preferito viene visualizzato per primo nell'ordine di enumerazione. Oggetto il cui CLSID viene visualizzato nell'elenco bloccato non è enumerato.

Gli elenchi vengono inizialmente popolati dal Registro di sistema. Le applicazioni possono usare l'interfaccia IMFPluginControl per modificare gli elenchi per il processo corrente.

L'elenco preferito contiene un set di coppie chiave/valore, in cui le chiavi sono stringhe e i valori sono CLSID. Queste coppie chiave/valore sono definite come segue:

  • Per le origini multimediali, il nome della chiave è un'estensione del nome file, uno schema di protocollo o un tipo MIME. Il valore è il CLSID di un gestore di schemi o di un gestore del flusso di byte per tale origine multimediale.
  • Per i decodificatori, il nome della chiave è un GUID di sottotipo multimediale in formato stringa canonico. Per altre informazioni sui sottotipi multimediali, vedere Tipi di supporti. Il valore è il CLSID della trasformazione Media Foundation (MFT) che implementa il decodificatore.
Gli esempi seguenti illustrano i vari tipi di chiave:
  • Estensione file: ".wmv"
  • Schema: "http:"
  • Tipo MIME: "video/mp4"
  • Sottotipo multimediale: "{47504A4D-0000-0010-8000-00AA00389B71}"
Per cercare l'elenco preferito in base al nome della chiave, chiamare il metodo IMFPluginControl::GetPreferredClsid . Per enumerare l'intero elenco, chiamare il metodo IMFPluginControl::GetPreferredClsidByIndex in un ciclo.

L'elenco bloccato contiene un elenco di CLSID. Per enumerare l'intero elenco, chiamare il metodo IMFPluginControl::GetDisabledByIndex in un ciclo. Per verificare se un CLSID specifico viene visualizzato nell'elenco, chiamare il metodo IMFPluginControl::IsDisabled .

Requisiti

   
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfobjects.h (include Mfidl.h)

Vedi anche

MFGetPluginControl

Interfacce di Media Foundation