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

MFCLOCK_PROPERTIES

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 48 バイト / x86: 48 バイト

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

フィールド

フィールド型サイズx64x86説明
qwCorrelationRateULONGLONG8+0+0クロックが自身のクロック時刻をシステム時刻と対応付ける間隔を、100 ナノ秒単位で指定します。値が 0 の場合、対応付けは IMFClock::GetCorrelatedTime メソッドが呼び出されるたびに行われます。
guidClockIdGUID16+8+8時刻を提供する基になるデバイスの一意の識別子です。2 つのクロックが同じ一意の識別子を持つ場合、それらは同じデバイスに基づいています。基になるデバイスが 2 つのクロック間で共有されていない場合、この値は GUID_NULL になることがあります。
dwClockFlagsDWORD4+24+24MFCLOCK_RELATIONAL_FLAGS 列挙型のフラグのビット単位の OR です。
qwClockFrequencyULONGLONG8+32+32クロックの周波数 (Hz) です。MFCLOCK_FREQUENCY_HNS という値は、クロックの周波数が 10 MHz (100 ナノ秒刻み) であることを意味します。これは Media Foundation における標準の MFTIME 時間単位です。IMFClock::GetClockCharacteristics メソッドが MFCLOCK_CHARACTERISTICS_FLAG_FREQUENCY_10MHZ フラグを返す場合、このフィールドの値は MFCLOCK_FREQUENCY_HNS でなければなりません。
dwClockToleranceDWORD4+40+40クロックに存在する可能性のある誤差の大きさを、10 億分率 (ppb) で表します。たとえば 50 ppb の誤差とは、実時間 10 億秒あたり最大 50 秒のずれが生じる可能性があることを意味します。許容誤差が不明な場合、値は MFCLOCK_TOLERANCE_UNKNOWN になります。この定数は 100 万分の 50 (ppm) に相当します。
dwClockJitterDWORD4+44+44

存在する可能性のあるジッターの大きさを、100 ナノ秒単位で表します。ジッターとは、基になるクロックをサンプリングすることによって生じる周波数の変動です。ジッターには、ドリフトによる誤差は含まれません。ドリフトによる誤差は dwClockTolerance の値に反映されます。

単一のデバイスに基づくクロックの場合、最小のジッターは 1 刻みの周期 (周波数の逆数) の長さになります。たとえば周波数が 10 Hz の場合、ジッターは 0.1 秒であり、MFTIME 単位では 1,000,000 になります。この値は、次の刻みの直前にクロックがサンプリングされ、その結果、実際の時刻より 1 周期分だけ小さいクロック時刻が得られる可能性があることを反映しています。周波数が 10 MHz を超える場合、ジッターは 1 (最小値) に設定してください。

クロックの基になるハードウェアデバイスが受信データに直接タイムスタンプを付けない場合、ジッターにはドライバーの割り込みサービスルーチン (ISR) をディスパッチするのに要する時間も含まれます。その場合、想定されるジッターには次の値を含める必要があります。

値 意味
MFCLOCK_JITTER_ISR
 デバイスドライバーの ISR 中にタイムスタンプを付けることによるジッターです。
MFCLOCK_JITTER_DPC
 遅延プロシージャ呼び出し (DPC) の処理中にタイムスタンプを付けることによるジッターです。
MFCLOCK_JITTER_PASSIVE
 タイムスタンプを付ける前に通常のスレッド実行に移行することによるジッターです。

公式ドキュメント

クロックのプロパティを定義します。

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

各言語での定義

#include <windows.h>

// MFCLOCK_PROPERTIES  (x64 48 / x86 48 バイト)
typedef struct MFCLOCK_PROPERTIES {
    ULONGLONG qwCorrelationRate;
    GUID guidClockId;
    DWORD dwClockFlags;
    ULONGLONG qwClockFrequency;
    DWORD dwClockTolerance;
    DWORD dwClockJitter;
} MFCLOCK_PROPERTIES;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MFCLOCK_PROPERTIES
{
    public ulong qwCorrelationRate;
    public Guid guidClockId;
    public uint dwClockFlags;
    public ulong qwClockFrequency;
    public uint dwClockTolerance;
    public uint dwClockJitter;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MFCLOCK_PROPERTIES
    Public qwCorrelationRate As ULong
    Public guidClockId As Guid
    Public dwClockFlags As UInteger
    Public qwClockFrequency As ULong
    Public dwClockTolerance As UInteger
    Public dwClockJitter As UInteger
End Structure
import ctypes
from ctypes import wintypes

class MFCLOCK_PROPERTIES(ctypes.Structure):
    _fields_ = [
        ("qwCorrelationRate", ctypes.c_ulonglong),
        ("guidClockId", GUID),
        ("dwClockFlags", wintypes.DWORD),
        ("qwClockFrequency", ctypes.c_ulonglong),
        ("dwClockTolerance", wintypes.DWORD),
        ("dwClockJitter", wintypes.DWORD),
    ]
#[repr(C)]
pub struct MFCLOCK_PROPERTIES {
    pub qwCorrelationRate: u64,
    pub guidClockId: GUID,
    pub dwClockFlags: u32,
    pub qwClockFrequency: u64,
    pub dwClockTolerance: u32,
    pub dwClockJitter: u32,
}
import "golang.org/x/sys/windows"

type MFCLOCK_PROPERTIES struct {
	qwCorrelationRate uint64
	guidClockId windows.GUID
	dwClockFlags uint32
	qwClockFrequency uint64
	dwClockTolerance uint32
	dwClockJitter uint32
}
type
  MFCLOCK_PROPERTIES = record
    qwCorrelationRate: UInt64;
    guidClockId: TGUID;
    dwClockFlags: DWORD;
    qwClockFrequency: UInt64;
    dwClockTolerance: DWORD;
    dwClockJitter: DWORD;
  end;
const MFCLOCK_PROPERTIES = extern struct {
    qwCorrelationRate: u64,
    guidClockId: GUID,
    dwClockFlags: u32,
    qwClockFrequency: u64,
    dwClockTolerance: u32,
    dwClockJitter: u32,
};
type
  MFCLOCK_PROPERTIES {.bycopy.} = object
    qwCorrelationRate: uint64
    guidClockId: GUID
    dwClockFlags: uint32
    qwClockFrequency: uint64
    dwClockTolerance: uint32
    dwClockJitter: uint32
struct MFCLOCK_PROPERTIES
{
    ulong qwCorrelationRate;
    GUID guidClockId;
    uint dwClockFlags;
    ulong qwClockFrequency;
    uint dwClockTolerance;
    uint dwClockJitter;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MFCLOCK_PROPERTIES サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; qwCorrelationRate : ULONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; guidClockId : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; dwClockFlags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; qwClockFrequency : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; dwClockTolerance : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwClockJitter : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global MFCLOCK_PROPERTIES
    #field int64 qwCorrelationRate
    #field GUID guidClockId
    #field int dwClockFlags
    #field int64 qwClockFrequency
    #field int dwClockTolerance
    #field int dwClockJitter
#endstruct

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