Udostępnij przez

Tworzenie obiektów osi czasu

[Funkcja skojarzona z tą stroną, DirectShow, jest starszą funkcją. Został zastąpiony przez MediaPlayer, IMFMediaEnginei Audio/Video Capture w Media Foundation. Te funkcje zostały zoptymalizowane pod kątem systemów Windows 10 i Windows 11. Firma Microsoft zdecydowanie zaleca, aby nowy kod używał MediaPlayer, IMFMediaEngine i Audio/Video Capture w programie Media Foundation zamiast DirectShow, jeśli to możliwe. Firma Microsoft sugeruje, że istniejący kod, który używa starszych interfejsów API, należy przepisać go do korzystania z nowych interfejsów API, jeśli to możliwe.]

[Ten interfejs API nie jest obsługiwany i może zostać zmieniony lub niedostępny w przyszłości.]

Przykładowy kod przedstawiony w tym artykule rozpoczyna się od pustej osi czasu, ale te same kroki mają zastosowanie w przypadku załadowania istniejącego projektu i dodania do niego obiektów.

Aby utworzyć dowolny typ obiektu na osi czasu, wywołaj metodę IAMTimeline::CreateEmptyNode. Na przykład poniższy kod tworzy nową grupę:

IAMTimelineObj *pGroupObj = NULL;
pTL->CreateEmptyNode(&pGroupObj, TIMELINE_MAJOR_TYPE_GROUP);

Drugi parametr jest członkiem wyliczenia TIMELINE_MAJOR_TYPE. Określa typ obiektu osi czasu do utworzenia, na przykład grupę lub ścieżkę.

Metoda CreateEmptyNode tworzy obiekt i zwraca wskaźnik do interfejsu IAMTimelineObj obiektu. Zwiększa również licznik odwołań w interfejsie IAMTimelineObj, dlatego należy zwolnić interfejs po zakończeniu korzystania z niego. Nie należy wywoływać funkcji CoCreateInstance. Zamiast tego zawsze należy użyć CreateEmptyNode, aby utworzyć obiekt osi czasu, ponieważ inicjuje nowy obiekt do użycia na osi czasu.

Interfejs IAMTimelineObj jest interfejsem ogólnym. Udostępnia metody wspólne dla wszystkich typów obiektów osi czasu. Każdy typ obiektu uwidacznia również inne interfejsy. Na przykład grupy uwidaczniają między innymi interfejs IAMTimelineGroup. Wskaźniki do innych interfejsów można uzyskać, wywołując QueryInterface.

Po utworzeniu obiektu nie jest jeszcze częścią osi czasu. Metoda dodawania obiektu do osi czasu zależy od typu obiektu. W poniższej sekcji opisano sposób dodawania grup, kompozycji i utworów do osi czasu.

konstruowanie osi czasu

 

 

  • Last updated on