建立時程表物件
[與此頁面相關聯的功能，DirectShow是舊版功能。 它已被 MediaPlayer、IMFMediaEngine和媒體基礎結構中的 音訊/視訊擷取取代。 這些功能已針對 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來取得其他介面的指標。
建立對象之後，它還不是時間軸的一部分。 將物件加入時程表的方法取決於物件類型。 下一節說明如何將群組、組合和軌道新增至時間軸。
相關主題