IAMTimeline::CreateEmptyNode
CreateEmptyNode メソッドは、新しいタイムライン オブジェクトを作成する。
このメソッドは重要な初期化ルーチンを実行するので、タイムラインの作成には、CoCreateInstance 関数ではなくこのメソッドを使うこと。このメソッドによって作成されるオブジェクトは、少なくとも IAMTimelineObj インターフェイスをサポートし、それと共にその型のオブジェクトに特有の他のインターフェイスもサポートする。
構文
HRESULT CreateEmptyNode(
IAMTimelineObj **ppObj,
TIMELINE_MAJOR_TYPE Type
);
パラメータ
ppObj
[out] 新しいオブジェクトの IAMTimelineObj インターフェイスを受け取るポインタのアドレス。
Type
TIMELINE_MAJOR_TYPE 列挙型のメンバ。作成するオブジェクトの型を指定する。
戻り値
次のいずれかの HRESULT 値を返す。
戻りコード | 説明 |
S_OK | 成功。 |
E_INVALIDARG | オブジェクトの型が有効ではない。 |
E_OUTOFMEMORY | メモリ不足。 |
E_POINTER | NULL ポインタ引数。 |
注意
別のタイムライン インスタンスに新しいオブジェクトを追加しないこと。タイムラインのすべてのオブジェクトは、そのタイムラインによって作成される必要がある。
メソッドが成功した場合、返される IAMTimelineObj インターフェイスに未処理の参照カウントが残る。使用後、インターフェイスを必ず解放すること。
要件
ヘッダー : Qedit.h をインクルードする。このヘッダー ファイルは、バージョン 7 以降の Microsoft® Direct3D® のヘッダーとは互換性がない。
ライブラリ : strmiids.lib を使用。
参照