共用方式為


建立時程表物件

[與此頁面相關聯的功能,DirectShow是舊版功能。 它已被 MediaPlayerIMFMediaEngine和媒體基礎結構中的 音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft強烈建議新程式代碼盡可能在媒體 基礎中使用 MediaPlayerIMFMediaEngine 音訊/視訊擷取,而不是 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來取得其他介面的指標。

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

建構時間軸