Condividi tramite

Selezione di un decodificatore in DirectShow Editing Services

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stato sostituito da MediaPlayer, IMFMediaEnginee acquisizione audio/video in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice utilizzi MediaPlayer, IMFMediaEngine e Acquisizione Audio/Video in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

[Questa API non è supportata e potrebbe essere modificata o non disponibile in futuro.]

Quando DirectShow Editing Services (DES) esegue il rendering di un progetto di modifica video, il motore di rendering seleziona automaticamente i decodificatori necessari. Questo problema può verificarsi all'interno del metodo IRenderEngine::ConnectFrontEnd o in modo dinamico durante il rendering.

Un utente potrebbe installare diversi decodificatori in grado di decodificare un determinato file. Quando sono disponibili più decodificatori, DES usa l'algoritmo Intelligent Connect per selezionare il decodificatore.

Non esiste alcun modo per l'applicazione di specificare direttamente quale decodificatore usare. Tuttavia, è possibile scegliere il decodificatore indirettamente tramite l'interfaccia callback IAMGraphBuilderCallback. Implementando questa interfaccia nell'applicazione, è possibile ricevere notifiche durante il processo di compilazione del grafo e rifiutare determinati filtri dal grafico.

Per iniziare, implementare una classe che espone l'interfaccia IAMGraphBuilderCallback:

class GraphBuilderCB : public IAMGraphBuilderCallback
{
public:
     // Method declarations (not shown).
};

Creare quindi un'istanza di Filter Graph Manager e registrare la classe per ricevere le notifiche di callback:

// Declare an instance of the callback object.
GraphBuilderCB GraphCB; 

// Create the Filter Graph Manager.
CComPtr<IGraphBuilder> pGraph;
hr = pGraph.CoCreateInstance(CLSID_FilterGraph);
if (FAILED(hr))
{
    // Handle error (not shown).
}
// Register to receive the callbacks.
CComQIPtr<IObjectWithSite> pSite(pGraph);
if (pSite)
{
    hr = pSite->SetSite((IUnknown*)&GraphCB);
}

Successivamente, crea il motore di rendering e chiama il metodo IRenderEngine::SetFilterGraph con un puntatore al Filter Graph Manager. Ciò garantisce che il motore di rendering non crei il proprio Filter Graph Manager, ma usi invece l'istanza configurata per i callback.

CComPtr<IRenderEngine> pRender;
hr = pRender.CoCreateInstance(CLSID_RenderEngine);
if (FAILED(hr))
{
    // Handle error (not shown).
}

hr = pRender->SetFilterGraph(pGraph);

Quando viene eseguito il rendering del progetto, il metodo IAMGraphBuilderCallback::SelectedFilterdell'applicazione viene chiamato immediatamente prima che il Filter Graph Managercrei un nuovo filtro. Il metodo SelectedFilter riceve un puntatore a un'interfaccia IMoniker che rappresenta un identificatore (moniker) per il filtro. Esaminare il moniker e, se si decide di rifiutare il filtro, restituire un codice di errore dal metodo SelectedFilter.

La parte difficile consiste nell'identificare i moniker che rappresentano decodificatori, in particolare i moniker che rappresentano decodificatori che si desidera rifiutare. Una soluzione è la seguente:

  • Prima di eseguire il rendering del progetto, utilizzare il metodo IFilterMapper2::EnumMatchingFilters per creare un elenco di filtri registrati come accettazione del tipo di input desiderato. Per i tipi di compressione video o audio, questo elenco deve essere mappato a un set di decodificatori.

  • Il metodo EnumMatchingFilters restituisce una raccolta di moniker. Per ogni moniker dell'insieme, ottenere la proprietà DisplayName, come descritto in Utilizzo del Mapper di Filtri.

  • Archiviare un elenco dei nomi visualizzati, ma omettere il nome visualizzato corrispondente al filtro da usare per la decodifica. I nomi visualizzati per i filtri software hanno il formato seguente:

    OLESTR("@device:sw:{CategoryGUID}\{FilterCLSID}");

    dove

    CategoryGUID

    è il GUID della categoria di filtri e

    FilterCLSID

    è il CLSID del filtro. Per le DMO, il formato rimane lo stesso, tuttavia modificare sw in dmo.

    L'elenco contiene ora nomi visualizzati per ogni filtro che restituisce il tipo di supporto desiderato, ma non è il filtro preferito.

  • Nel metodo SelectedFilter, ottenere la proprietà DisplayName sul moniker proposto e confrontarla con l'elenco memorizzato. Se il nome visualizzato corrisponde a una voce nell'elenco, rifiutare tale filtro. In caso contrario, accettarlo restituendo S_OK.

Rendering di un di progetto

 

 

  • Last updated on