ホーム › Media.WindowsMediaFormat › WMT_TIMECODE_EXTENSION_DATA

WMT_TIMECODE_EXTENSION_DATA

構造体

サイズx64: 14 バイト / x86: 14 バイトパッキング2

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド	型	サイズ	x64	x86	説明
wRange	WORD	2	+0	+0	タイムコードが属する範囲を指定する WORD です。「解説」を参照してください。
dwTimecode	DWORD	4	+2	+2	BCD形式等で表されたタイムコード値。
dwUserbits	DWORD	4	+6	+6	ユーザーが必要とする任意の情報を格納する DWORD です。通常、このメンバーはショット番号やテイク番号、その他制作工程に関連する情報の格納に使用されます。
dwAmFlags	DWORD	4	+10	+10	ソース素材に含まれる AM_TIMECODE フラグを保持するために用意された DWORD です。これらのフラグは、Windows Media Format SDK のいずれのオブジェクトでも使用されません。AM_TIMECODE フラグの詳細については、SMPTE タイムコード仕様を参照してください。 - Timecode タイムコードを格納する DWORD です。タイムコードは、16 進値がそのまま 10 進値として読み取れる形式で格納されます。つまり、タイムコード値 0x01133512 は 10 進数の 18035986 を表すのではなく、1 時間 13 分 35 秒 12 フレームを指定します。

公式ドキュメント

[このページに関連する機能である Windows Media Format 11 SDK はレガシー機能です。この機能は Source Reader および Sink Writer に置き換えられました。Source Reader と Sink Writer は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、可能な場合は新しいコードで Windows Media Format 11 SDK ではなく Source Reader と Sink Writer を使用することを強く推奨します。また、レガシー API を使用する既存のコードについても、可能であれば新しい API を使用するように書き換えることを推奨します。]

WMT_TIMECODE_EXTENSION_DATA 構造体は、1 つの SMPTE タイムコードサンプル拡張に必要な情報を格納します。SMPTE タイムコードを必要とするすべてのビデオフレームに、この構造体が 1 つ添付されます。

解説(Remarks)

SMPTE の比較的一般的な利用シナリオの 1 つは、ソースリールから複数のクリップを集めて編集素材を構成し、その編集結果にソースリールのタイムコードを保持するというものです。この種類のファイルのタイムコードは、互いに連続しない一連の SMPTE 範囲で構成され、各範囲はそのソースリールのリニアタイムコードに対応します。

これらの範囲は時間的な順序で並んでいることが保証されないため (言い換えると、最初の範囲が 2 番目の範囲よりも時間的に早く発生する場合があります)、Windows Media Format SDK のタイムコードインデックスおよびインターフェイスでは範囲という概念がサポートされています。SMPTE タイムコードは、指定された範囲内では時間とともに増加しなければなりません。範囲内の軽微な不連続 (フレーム落ちやドロップフレームカウントなど) は、範囲内で示す必要はありません。

WMV ファイル内では、範囲は単調増加すること (言い換えると 0、1、2、3、… ) が保証されます。SMPTE タイムコード値は、WMV ファイル内の指定された範囲内では増加することが保証されますが、範囲をまたぐ場合は保証されません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// WMT_TIMECODE_EXTENSION_DATA  (x64 14 / x86 14 バイト)
#pragma pack(push, 2)
typedef struct WMT_TIMECODE_EXTENSION_DATA {
    WORD wRange;
    DWORD dwTimecode;
    DWORD dwUserbits;
    DWORD dwAmFlags;
} WMT_TIMECODE_EXTENSION_DATA;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 2, CharSet = CharSet.Unicode)]
public struct WMT_TIMECODE_EXTENSION_DATA
{
    public ushort wRange;
    public uint dwTimecode;
    public uint dwUserbits;
    public uint dwAmFlags;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=2, CharSet:=CharSet.Unicode)>
Public Structure WMT_TIMECODE_EXTENSION_DATA
    Public wRange As UShort
    Public dwTimecode As UInteger
    Public dwUserbits As UInteger
    Public dwAmFlags As UInteger
End Structure

import ctypes
from ctypes import wintypes

class WMT_TIMECODE_EXTENSION_DATA(ctypes.Structure):
    _pack_ = 2
    _fields_ = [
        ("wRange", ctypes.c_ushort),
        ("dwTimecode", wintypes.DWORD),
        ("dwUserbits", wintypes.DWORD),
        ("dwAmFlags", wintypes.DWORD),
    ]

#[repr(C, packed(2))]
pub struct WMT_TIMECODE_EXTENSION_DATA {
    pub wRange: u16,
    pub dwTimecode: u32,
    pub dwUserbits: u32,
    pub dwAmFlags: u32,
}

import "golang.org/x/sys/windows"

type WMT_TIMECODE_EXTENSION_DATA struct {
	wRange uint16
	dwTimecode uint32
	dwUserbits uint32
	dwAmFlags uint32
}

type
  WMT_TIMECODE_EXTENSION_DATA = packed record
    wRange: Word;
    dwTimecode: DWORD;
    dwUserbits: DWORD;
    dwAmFlags: DWORD;
  end;

const WMT_TIMECODE_EXTENSION_DATA = extern struct {
    wRange: u16,
    dwTimecode: u32,
    dwUserbits: u32,
    dwAmFlags: u32,
};

type
  WMT_TIMECODE_EXTENSION_DATA {.packed.} = object
    wRange: uint16
    dwTimecode: uint32
    dwUserbits: uint32
    dwAmFlags: uint32

align(2)
struct WMT_TIMECODE_EXTENSION_DATA
{
    ushort wRange;
    uint dwTimecode;
    uint dwUserbits;
    uint dwAmFlags;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WMT_TIMECODE_EXTENSION_DATA サイズ: 14 バイト(x64)
dim st, 4    ; 4byte整数×4(構造体サイズ 14 / 4 切り上げ)
; wRange : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; dwTimecode : DWORD (+2, 4byte)  lpoke st,2,値  /  値 = lpeek(st,2)
; dwUserbits : DWORD (+6, 4byte)  lpoke st,6,値  /  値 = lpeek(st,6)
; dwAmFlags : DWORD (+10, 4byte)  lpoke st,10,値  /  値 = lpeek(st,10)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WMT_TIMECODE_EXTENSION_DATA, pack=2
    #field short wRange
    #field int dwTimecode
    #field int dwUserbits
    #field int dwAmFlags
#endstruct

stdim st, WMT_TIMECODE_EXTENSION_DATA        ; NSTRUCT 変数を確保
st->wRange = 100
mes "wRange=" + st->wRange