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

DXVA_COPPStatusDisplayData

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

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

フィールド

フィールド型サイズx64x86説明
rAppGUID16+0+0アプリケーションが AMCOPPStatusInput 構造体で渡した 128 ビットの乱数です。
dwFlagsDWORD4+16+16状態フラグです。COPP_StatusFlags を参照してください。
DisplayWidthDWORD4+20+20ディスプレイモードの幅 (ピクセル単位) です。
DisplayHeightDWORD4+24+24ディスプレイモードの高さ (ピクセル単位) です。
FormatDWORD4+28+28ビデオ形式を表す DXVA_ExtendedFormat 構造体を ULONG にパックして格納します。
d3dFormatDWORD4+32+32ビデオ形式を表す D3DFORMAT 値を格納します。詳細については、Direct3D SDK のドキュメントを参照してください。
FreqNumeratorDWORD4+36+36現在のディスプレイモードのリフレッシュレートの分子です。
FreqDenominatorDWORD4+40+40現在のディスプレイモードのリフレッシュレートの分母です。

公式ドキュメント

[このページに関連する機能である 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 を使用するように書き直すことを推奨します。]

Certified Output Protection Protocol (COPP) における Display Data クエリの結果を格納します。

解説(Remarks)

リフレッシュレートは分数で表されます。たとえば、リフレッシュレートが 72 Hz の場合、FreqNumerator = 72、FreqDenominator = 1 となります。NTSC テレビの場合は FreqNumerator = 60000、FreqDenominator = 1001 (1 秒あたり 59.94 フィールド) となります。

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

各言語での定義

#include <windows.h>

// DXVA_COPPStatusDisplayData  (x64 44 / x86 44 バイト)
typedef struct DXVA_COPPStatusDisplayData {
    GUID rApp;
    DWORD dwFlags;
    DWORD DisplayWidth;
    DWORD DisplayHeight;
    DWORD Format;
    DWORD d3dFormat;
    DWORD FreqNumerator;
    DWORD FreqDenominator;
} DXVA_COPPStatusDisplayData;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXVA_COPPStatusDisplayData
{
    public Guid rApp;
    public uint dwFlags;
    public uint DisplayWidth;
    public uint DisplayHeight;
    public uint Format;
    public uint d3dFormat;
    public uint FreqNumerator;
    public uint FreqDenominator;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXVA_COPPStatusDisplayData
    Public rApp As Guid
    Public dwFlags As UInteger
    Public DisplayWidth As UInteger
    Public DisplayHeight As UInteger
    Public Format As UInteger
    Public d3dFormat As UInteger
    Public FreqNumerator As UInteger
    Public FreqDenominator As UInteger
End Structure
import ctypes
from ctypes import wintypes

class DXVA_COPPStatusDisplayData(ctypes.Structure):
    _fields_ = [
        ("rApp", GUID),
        ("dwFlags", wintypes.DWORD),
        ("DisplayWidth", wintypes.DWORD),
        ("DisplayHeight", wintypes.DWORD),
        ("Format", wintypes.DWORD),
        ("d3dFormat", wintypes.DWORD),
        ("FreqNumerator", wintypes.DWORD),
        ("FreqDenominator", wintypes.DWORD),
    ]
#[repr(C)]
pub struct DXVA_COPPStatusDisplayData {
    pub rApp: GUID,
    pub dwFlags: u32,
    pub DisplayWidth: u32,
    pub DisplayHeight: u32,
    pub Format: u32,
    pub d3dFormat: u32,
    pub FreqNumerator: u32,
    pub FreqDenominator: u32,
}
import "golang.org/x/sys/windows"

type DXVA_COPPStatusDisplayData struct {
	rApp windows.GUID
	dwFlags uint32
	DisplayWidth uint32
	DisplayHeight uint32
	Format uint32
	d3dFormat uint32
	FreqNumerator uint32
	FreqDenominator uint32
}
type
  DXVA_COPPStatusDisplayData = record
    rApp: TGUID;
    dwFlags: DWORD;
    DisplayWidth: DWORD;
    DisplayHeight: DWORD;
    Format: DWORD;
    d3dFormat: DWORD;
    FreqNumerator: DWORD;
    FreqDenominator: DWORD;
  end;
const DXVA_COPPStatusDisplayData = extern struct {
    rApp: GUID,
    dwFlags: u32,
    DisplayWidth: u32,
    DisplayHeight: u32,
    Format: u32,
    d3dFormat: u32,
    FreqNumerator: u32,
    FreqDenominator: u32,
};
type
  DXVA_COPPStatusDisplayData {.bycopy.} = object
    rApp: GUID
    dwFlags: uint32
    DisplayWidth: uint32
    DisplayHeight: uint32
    Format: uint32
    d3dFormat: uint32
    FreqNumerator: uint32
    FreqDenominator: uint32
struct DXVA_COPPStatusDisplayData
{
    GUID rApp;
    uint dwFlags;
    uint DisplayWidth;
    uint DisplayHeight;
    uint Format;
    uint d3dFormat;
    uint FreqNumerator;
    uint FreqDenominator;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DXVA_COPPStatusDisplayData サイズ: 44 バイト(x64)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; rApp : GUID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; dwFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DisplayWidth : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; DisplayHeight : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Format : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; d3dFormat : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; FreqNumerator : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; FreqDenominator : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (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 DXVA_COPPStatusDisplayData
    #field GUID rApp
    #field int dwFlags
    #field int DisplayWidth
    #field int DisplayHeight
    #field int Format
    #field int d3dFormat
    #field int FreqNumerator
    #field int FreqDenominator
#endstruct

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