Funzione MFCreateTranscodeTopology (mfidl.h)
Crea una topologia di transcode parziale.
Il generatore di topologie sottostante crea una topologia parziale connettendo gli oggetti della pipeline necessari: origine, codificatore e sink. Il codificatore e il sink sono configurati in base alle impostazioni specificate dal chiamante nel profilo transcode.
Per creare l'oggetto profilo transcode, chiamare la funzione MFCreateTranscodeProfile e impostare gli attributi richiesti chiamando i metodi FMTranscodeProfile appropriati.
Il profilo transcode configurato viene passato alla funzione MFCreateTranscodeTopology , che crea la topologia di transcode con le impostazioni appropriate. Il chiamante può quindi impostare questa topologia nella sessione multimediale e avviare la sessione per avviare il processo di codifica. Al termine della sessione multimediale, viene generato il file transcoded.
Sintassi
HRESULT MFCreateTranscodeTopology(
[in] IMFMediaSource *pSrc,
[in] LPCWSTR pwszOutputFilePath,
[in] IMFTranscodeProfile *pProfile,
[out] IMFTopology **ppTranscodeTopo
);
Parametri
[in] pSrc
Puntatore a un'origine multimediale che incapsula il file di origine da transcodificare. L'oggetto origine multimediale espone l'interfaccia FMMediaSource e può essere creata usando il resolver di origine. Per altre informazioni, vedere Uso del resolver di origine.
[in] pwszOutputFilePath
Puntatore a una stringa con terminazione null contenente il nome e il percorso del file di output da generare.
[in] pProfile
Puntatore al profilo di transcodice che contiene le impostazioni di configurazione per il flusso audio, il flusso video e il contenitore in cui viene scritto il file. L'oggetto profilo transcode espone l'interfaccia FMTranscodeProfile e deve essere creata chiamando la funzione MFCreateTranscodeProfile . Dopo aver creato l'oggetto, il chiamante deve fornire le impostazioni di configurazione chiamando i metodi IMFTranscodeProfile appropriati.
[out] ppTranscodeTopo
Riceve un puntatore all'interfaccia IMFTo topologia dell'oggetto topologia transcode. Il chiamante deve rilasciare l'interfaccia.
Valore restituito
La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
La chiamata alla funzione ha avuto esito positivo e ppTranscodeTopo riceve un puntatore alla topologia di transcode. |
|
pwszOutputFilePath contiene caratteri non validi. |
|
Nessun flusso è selezionato nell'origine multimediale. |
|
Il profilo non contiene l'attributo MF_TRANSCODE_CONTAINERTYPE . |
|
Per uno o più flussi, non è possibile trovare un codificatore che accetta il tipo di supporto specificato nel profilo. |
|
Il profilo non specifica un tipo di supporto per uno dei flussi selezionati nell'origine multimediale. |
Commenti
Ad esempio, il codice che usa questa funzione, vedere gli argomenti seguenti:
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mfidl.h |
| Libreria | Mf.lib |
| DLL | Mf.dll |