共用方式為

建立時間軸物件

  • 發行項

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

[不支援此 API，未來可能會改變或無法使用。]

本文中呈現的範例程式碼會以空的時間軸開始，但當您載入現有的專案並想要將物件加入其中時，會套用相同的步驟。

若要在時程表中建立任何類型的物件，請呼叫 IAMTimeline：：CreateEmptyNode 方法。 例如，下列程式碼會建立新的群組：

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

第二個參數是 TIMELINE_MAJOR_TYPE 列舉的成員。 它會指定要建立的時程表物件類型，例如群組或追蹤。

CreateEmptyNode方法會建立 物件，並傳回物件的IAMTimelineObj介面指標。 它也會遞增 IAMTimelineObj 介面上的參考計數，因此當您完成使用它時，必須釋放介面。 請勿呼叫 CoCreateInstance 函式。 相反地，請一律使用 CreateEmptyNode 來建立時程表物件，因為它會初始化新物件以在時程表中使用。

IAMTimelineObj介面是泛型介面。 它提供所有時間軸物件類型通用的方法。 每個類型的物件也會公開其他介面。 例如，群組會公開 IAMTimelineGroup 介面等等。 您可以藉由呼叫 QueryInterface來取得其他介面的指標。

建立物件之後，它還不是時間軸的一部分。 將物件加入時程表的方法取決於物件類型。 下一節說明如何將群組、組合和追蹤新增至時程表。

建構時程表