ホーム › Media.DirectShow › Quality
Quality
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| Type | QualityMessageType | 4 | +0 | +0 | QualityMessageType 列挙型の値で、ダウンストリームのフィルターがより多くのデータを必要としているか、より少ないデータを必要としているかを示します。 |
| Proportion | INT | 4 | +4 | +4 | DirectShow がメディアサンプルの送信を継続する際のレートを指定する値です。基準値は 1000 で、変更が不要であることを示します。1000 からの増減の割合が、追加または破棄するフレームの割合を示します。たとえばこの値が 800 の場合、DirectShow はレンダラーの速度に合わせるために、入力フレームの 20 パーセントを破棄します。 |
| Late | LONGLONG | 8 | +8 | +8 | ダウンストリームで famine が発生している場合、ストリームが遅延している時間を示します。 |
| TimeStamp | LONGLONG | 8 | +16 | +16 | DirectShow がこの構造体を作成した時刻を指定する値です。通常はビデオサンプルの開始時刻になります。 |
公式ドキュメント
[このページに関連する機能である DirectShow は、レガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられています。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、可能な場合には新しいコードで DirectShow ではなく MediaPlayer、IMFMediaEngine、Audio/Video Capture in Media Foundation を使用することを強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き直すことを推奨します。]
Quality 構造体は、レンダラーにおける Flood または Famine を示し、レンダラーのパフォーマンスを最適化するために破棄または追加するフレームの割合を指定することで、品質メッセージを記述します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// Quality (x64 24 / x86 24 バイト)
typedef struct Quality {
QualityMessageType Type;
INT Proportion;
LONGLONG Late;
LONGLONG TimeStamp;
} Quality;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct Quality
{
public int Type;
public int Proportion;
public long Late;
public long TimeStamp;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure Quality
Public Type As Integer
Public Proportion As Integer
Public Late As Long
Public TimeStamp As Long
End Structureimport ctypes
from ctypes import wintypes
class Quality(ctypes.Structure):
_fields_ = [
("Type", ctypes.c_int),
("Proportion", ctypes.c_int),
("Late", ctypes.c_longlong),
("TimeStamp", ctypes.c_longlong),
]#[repr(C)]
pub struct Quality {
pub Type: i32,
pub Proportion: i32,
pub Late: i64,
pub TimeStamp: i64,
}import "golang.org/x/sys/windows"
type Quality struct {
Type int32
Proportion int32
Late int64
TimeStamp int64
}type
Quality = record
Type: Integer;
Proportion: Integer;
Late: Int64;
TimeStamp: Int64;
end;const Quality = extern struct {
Type: i32,
Proportion: i32,
Late: i64,
TimeStamp: i64,
};type
Quality {.bycopy.} = object
Type: int32
Proportion: int32
Late: int64
TimeStamp: int64struct Quality
{
int Type;
int Proportion;
long Late;
long TimeStamp;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; Quality サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; Type : QualityMessageType (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Proportion : INT (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Late : LONGLONG (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; TimeStamp : LONGLONG (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global Quality
#field int Type
#field int Proportion
#field int64 Late
#field int64 TimeStamp
#endstruct
stdim st, Quality ; NSTRUCT 変数を確保
st->Type = 100
mes "Type=" + st->Type