Win32 API 日本語リファレンス
ホームMedia.WindowsMediaFormat › WM_SYNCHRONISED_LYRICS

WM_SYNCHRONISED_LYRICS

構造体
サイズx64: 22 バイト / x86: 14 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
bTimeStampFormatBYTE1+0+0

歌詞内のタイム スタンプの形式を指定する BYTE です。次のいずれかの値を設定します。

説明
1 タイム スタンプは、歌詞の絶対時間をフレーム番号で格納する 32 ビット値です。
2 タイム スタンプは、歌詞の絶対時間をミリ秒単位で格納する 32 ビット値です。
bContentTypeBYTE1+1+1

歌詞データに含まれる同期文字列の種類を指定する BYTE です。次のいずれかの値を設定します。

説明
0 この表に示されている種類以外の同期文字列
1 曲の歌詞
2 テキストの書き起こし
3 コンテンツの各部分の名称。たとえば、"Adagio" のようなクラシック音楽の楽章名
4 オペラの舞台指示などのイベント
5 コード (和音) の表記
6 トリビア情報
7 Web ページへの URL
8 画像への URL
pwszContentDescriptorLPWSTR8/4+2+2エンコードを行うアプリケーションからのデータを格納する、ワイド文字の null 終端文字列へのポインターです。個々のアプリケーションは、このメンバーを任意の目的で使用できます。
dwLyricsLenDWORD4+10+6pbLyrics が指す歌詞データの長さをバイト単位で格納する DWORD です。
pbLyricsBYTE*8/4+14+10歌詞を格納する BYTE 配列へのポインターです。歌詞は音節単位に分割することも、アプリケーションの必要に応じて別の方法で分割することもできます。各音節または各部分は、null 終端のワイド文字列と、それに続く 32 ビットのタイム スタンプとして格納されます。タイム スタンプの単位は、bTimeStampFormat の値によって決まります。

公式ドキュメント

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

WM_SYNCHRONISED_LYRICS 構造体は、WM/Lyrics_Synchronised 複合メタデータ属性のデータ項目として使用されます。

解説(Remarks)

Windows Media Format SDK のオブジェクトは、同期歌詞のタイム スタンプの値を検証しません。ただし、すべての文字列にタイム スタンプが存在すること、およびデータが文字列と整数で交互に並んでいることは検査されます。

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

各言語での定義

#include <windows.h>

// WM_SYNCHRONISED_LYRICS  (x64 22 / x86 14 バイト)
#pragma pack(push, 1)
typedef struct WM_SYNCHRONISED_LYRICS {
    BYTE bTimeStampFormat;
    BYTE bContentType;
    LPWSTR pwszContentDescriptor;
    DWORD dwLyricsLen;
    BYTE* pbLyrics;
} WM_SYNCHRONISED_LYRICS;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct WM_SYNCHRONISED_LYRICS
{
    public byte bTimeStampFormat;
    public byte bContentType;
    public IntPtr pwszContentDescriptor;
    public uint dwLyricsLen;
    public IntPtr pbLyrics;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure WM_SYNCHRONISED_LYRICS
    Public bTimeStampFormat As Byte
    Public bContentType As Byte
    Public pwszContentDescriptor As IntPtr
    Public dwLyricsLen As UInteger
    Public pbLyrics As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class WM_SYNCHRONISED_LYRICS(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("bTimeStampFormat", ctypes.c_ubyte),
        ("bContentType", ctypes.c_ubyte),
        ("pwszContentDescriptor", ctypes.c_void_p),
        ("dwLyricsLen", wintypes.DWORD),
        ("pbLyrics", ctypes.c_void_p),
    ]
#[repr(C, packed(1))]
pub struct WM_SYNCHRONISED_LYRICS {
    pub bTimeStampFormat: u8,
    pub bContentType: u8,
    pub pwszContentDescriptor: *mut core::ffi::c_void,
    pub dwLyricsLen: u32,
    pub pbLyrics: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type WM_SYNCHRONISED_LYRICS struct {
	bTimeStampFormat byte
	bContentType byte
	pwszContentDescriptor uintptr
	dwLyricsLen uint32
	pbLyrics uintptr
}
type
  WM_SYNCHRONISED_LYRICS = packed record
    bTimeStampFormat: Byte;
    bContentType: Byte;
    pwszContentDescriptor: Pointer;
    dwLyricsLen: DWORD;
    pbLyrics: Pointer;
  end;
const WM_SYNCHRONISED_LYRICS = extern struct {
    bTimeStampFormat: u8,
    bContentType: u8,
    pwszContentDescriptor: ?*anyopaque,
    dwLyricsLen: u32,
    pbLyrics: ?*anyopaque,
};
type
  WM_SYNCHRONISED_LYRICS {.packed.} = object
    bTimeStampFormat: uint8
    bContentType: uint8
    pwszContentDescriptor: pointer
    dwLyricsLen: uint32
    pbLyrics: pointer
align(1)
struct WM_SYNCHRONISED_LYRICS
{
    ubyte bTimeStampFormat;
    ubyte bContentType;
    void* pwszContentDescriptor;
    uint dwLyricsLen;
    void* pbLyrics;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; WM_SYNCHRONISED_LYRICS サイズ: 14 バイト(x86)
dim st, 4    ; 4byte整数×4(構造体サイズ 14 / 4 切り上げ)
; bTimeStampFormat : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; bContentType : BYTE (+1, 1byte)  poke st,1,値  /  値 = peek(st,1)
; pwszContentDescriptor : LPWSTR (+2, 4byte)  lpoke st,2,値  /  値 = lpeek(st,2)
; dwLyricsLen : DWORD (+6, 4byte)  lpoke st,6,値  /  値 = lpeek(st,6)
; pbLyrics : BYTE* (+10, 4byte)  lpoke st,10,値  /  値 = lpeek(st,10)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WM_SYNCHRONISED_LYRICS サイズ: 22 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 22 / 4 切り上げ)
; bTimeStampFormat : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; bContentType : BYTE (+1, 1byte)  poke st,1,値  /  値 = peek(st,1)
; pwszContentDescriptor : LPWSTR (+2, 8byte)  qpoke st,2,値 / qpeek(st,2)  ※IronHSPのみ。3.7/3.8は lpoke st,2,下位 : lpoke st,6,上位
; dwLyricsLen : DWORD (+10, 4byte)  lpoke st,10,値  /  値 = lpeek(st,10)
; pbLyrics : BYTE* (+14, 8byte)  qpoke st,14,値 / qpeek(st,14)  ※IronHSPのみ。3.7/3.8は lpoke st,14,下位 : lpoke st,18,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WM_SYNCHRONISED_LYRICS, pack=1
    #field byte bTimeStampFormat
    #field byte bContentType
    #field intptr pwszContentDescriptor
    #field int dwLyricsLen
    #field intptr pbLyrics
#endstruct

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