Metodo IAMTimeline::CreateEmptyNode

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture 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.

Nota

[Deprecata. Questa API può essere rimossa dalle versioni future di Windows.]

 

Il CreateEmptyNode metodo crea un nuovo oggetto sequenza temporale.

Utilizzare questo metodo per creare oggetti sequenza temporale, anziché la funzione CoCreateInstance , perché questo metodo esegue routine di inizializzazione importanti. Ogni oggetto creato da questo metodo supporta almeno l'interfaccia IAMTimelineObj , insieme ad altre interfacce specifiche di quel tipo di oggetto.

Sintassi

HRESULT CreateEmptyNode(
  [out] IAMTimelineObj      **ppObj,
        TIMELINE_MAJOR_TYPE Type
);

Parametri

ppObj [out]

Riceve un puntatore all'interfaccia IAMTimelineObj del nuovo oggetto.

Tipo

Membro del TIMELINE_MAJOR_TYPE tipo enumerato, specificando il tipo di oggetto da creare.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Non aggiungere il nuovo oggetto a un'altra istanza della sequenza temporale. Ogni oggetto in una sequenza temporale deve essere creato da tale sequenza temporale.

Se il metodo ha esito positivo, l'interfaccia IAMTimelineObj restituita ha un conteggio dei riferimenti in sospeso. Assicurarsi di rilasciare l'interfaccia al termine dell'uso.

Nota

Il file di intestazione Qedit.h non è compatibile con le intestazioni Direct3D successive alla versione 7.

 

Nota

Per ottenere Qedit.h, scaricare l'aggiornamento Microsoft Windows SDK per Windows Vista e .NET Framework 3.0. Qedit.h non è disponibile nella Microsoft Windows SDK per Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisiti

Requisito	Valore
Intestazione	Qedit.h
Libreria	Strmiids.lib

Vedi anche

Interfaccia IAMTimeline

Codici di errore e di esito positivo