ホーム › Media.MediaFoundation › OPM_ACP_AND_CGMSA_SIGNALING

OPM_ACP_AND_CGMSA_SIGNALING

構造体

サイズx64: 88 バイト / x86: 88 バイトパッキング1

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

フィールド

フィールド	型	サイズ	x64	x86	説明
rnRandomNumber	OPM_RANDOM_NUMBER	16	+0	+0	OPM_RANDOM_NUMBER 構造体です。この構造体には、アプリケーションが OPM_GET_INFO_PARAMETERS 構造体または OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS 構造体でドライバーに送信したものと同じ 128 ビットの乱数が格納されます。
ulStatusFlags	DWORD	4	+16	+16	OPM Status Flags のビット単位の OR です。
ulAvailableTVProtectionStandards	DWORD	4	+20	+20	0 個以上の TV Protection Standard Flags のビット単位の OR です。ドライバーは、現在有効かどうかにかかわらず、サポートするすべての保護規格と解像度のフラグを返します。
ulActiveTVProtectionStandard	DWORD	4	+24	+24	TV Protection Standard Flags のうちの 1 つの値で、現在有効な保護規格を示します。
ulReserved	DWORD	4	+28	+28	将来の使用のために予約済みです。0 を設定してください。
ulAspectRatioValidMask1	DWORD	4	+32	+32	ulAspectRatioData1 のどのビットが有効かを示すビットマスクです。
ulAspectRatioData1	DWORD	4	+36	+36	現在のアスペクト比です。EN 300 294 の場合、この値は OPM_IMAGE_ASPECT_RATIO_EN300294 列挙型のメンバーです。
ulAspectRatioValidMask2	DWORD	4	+40	+40	ulAspectRatioData2 のどのビットが有効かを示すビットマスクです。
ulAspectRatioData2	DWORD	4	+44	+44	現在の保護規格におけるアスペクト比に関連する追加のデータ要素です。このデータの有無と意味は保護規格によって異なります。このフィールドは、EIA-608-B の End ビットおよび Q0 ビット、または CEA-805-A のアクティブフォーマット記述子を伝えるために使用できます。
ulAspectRatioValidMask3	DWORD	4	+48	+48	ulAspectRatioData3 のどのビットが有効かを示すビットマスクです。
ulAspectRatioData3	DWORD	4	+52	+52	現在の保護規格におけるアスペクト比に関連する追加のデータ要素です。このデータの有無と意味は保護規格によって異なります。
ulReserved2	DWORD	16	+56	+56	将来の使用のために予約済みです。この配列は 0 で埋めてください。
ulReserved3	DWORD	16	+72	+72	将来の使用のために予約済みです。この配列は 0 で埋めてください。

公式ドキュメント

OPM_GET_ACP_AND_CGMSA_SIGNALING クエリの結果を格納します。

解説(Remarks)

この構造体のレイアウトは、Certified Output Protection Protocol (COPP) で使用される DXVA_COPPStatusSignalingCmdData 構造体と同一です。

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

各言語での定義

#include <windows.h>

// OPM_RANDOM_NUMBER  (x64 16 / x86 16 バイト)
typedef struct OPM_RANDOM_NUMBER {
    BYTE abRandomNumber[16];
} OPM_RANDOM_NUMBER;

// OPM_ACP_AND_CGMSA_SIGNALING  (x64 88 / x86 88 バイト)
#pragma pack(push, 1)
typedef struct OPM_ACP_AND_CGMSA_SIGNALING {
    OPM_RANDOM_NUMBER rnRandomNumber;
    DWORD ulStatusFlags;
    DWORD ulAvailableTVProtectionStandards;
    DWORD ulActiveTVProtectionStandard;
    DWORD ulReserved;
    DWORD ulAspectRatioValidMask1;
    DWORD ulAspectRatioData1;
    DWORD ulAspectRatioValidMask2;
    DWORD ulAspectRatioData2;
    DWORD ulAspectRatioValidMask3;
    DWORD ulAspectRatioData3;
    DWORD ulReserved2[4];
    DWORD ulReserved3[4];
} OPM_ACP_AND_CGMSA_SIGNALING;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OPM_RANDOM_NUMBER
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public byte[] abRandomNumber;
}

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct OPM_ACP_AND_CGMSA_SIGNALING
{
    public OPM_RANDOM_NUMBER rnRandomNumber;
    public uint ulStatusFlags;
    public uint ulAvailableTVProtectionStandards;
    public uint ulActiveTVProtectionStandard;
    public uint ulReserved;
    public uint ulAspectRatioValidMask1;
    public uint ulAspectRatioData1;
    public uint ulAspectRatioValidMask2;
    public uint ulAspectRatioData2;
    public uint ulAspectRatioValidMask3;
    public uint ulAspectRatioData3;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] ulReserved2;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] ulReserved3;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OPM_RANDOM_NUMBER
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public abRandomNumber() As Byte
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure OPM_ACP_AND_CGMSA_SIGNALING
    Public rnRandomNumber As OPM_RANDOM_NUMBER
    Public ulStatusFlags As UInteger
    Public ulAvailableTVProtectionStandards As UInteger
    Public ulActiveTVProtectionStandard As UInteger
    Public ulReserved As UInteger
    Public ulAspectRatioValidMask1 As UInteger
    Public ulAspectRatioData1 As UInteger
    Public ulAspectRatioValidMask2 As UInteger
    Public ulAspectRatioData2 As UInteger
    Public ulAspectRatioValidMask3 As UInteger
    Public ulAspectRatioData3 As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public ulReserved2() As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public ulReserved3() As UInteger
End Structure

import ctypes
from ctypes import wintypes

class OPM_RANDOM_NUMBER(ctypes.Structure):
    _fields_ = [
        ("abRandomNumber", ctypes.c_ubyte * 16),
    ]

class OPM_ACP_AND_CGMSA_SIGNALING(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("rnRandomNumber", OPM_RANDOM_NUMBER),
        ("ulStatusFlags", wintypes.DWORD),
        ("ulAvailableTVProtectionStandards", wintypes.DWORD),
        ("ulActiveTVProtectionStandard", wintypes.DWORD),
        ("ulReserved", wintypes.DWORD),
        ("ulAspectRatioValidMask1", wintypes.DWORD),
        ("ulAspectRatioData1", wintypes.DWORD),
        ("ulAspectRatioValidMask2", wintypes.DWORD),
        ("ulAspectRatioData2", wintypes.DWORD),
        ("ulAspectRatioValidMask3", wintypes.DWORD),
        ("ulAspectRatioData3", wintypes.DWORD),
        ("ulReserved2", wintypes.DWORD * 4),
        ("ulReserved3", wintypes.DWORD * 4),
    ]

#[repr(C)]
pub struct OPM_RANDOM_NUMBER {
    pub abRandomNumber: [u8; 16],
}

#[repr(C, packed(1))]
pub struct OPM_ACP_AND_CGMSA_SIGNALING {
    pub rnRandomNumber: OPM_RANDOM_NUMBER,
    pub ulStatusFlags: u32,
    pub ulAvailableTVProtectionStandards: u32,
    pub ulActiveTVProtectionStandard: u32,
    pub ulReserved: u32,
    pub ulAspectRatioValidMask1: u32,
    pub ulAspectRatioData1: u32,
    pub ulAspectRatioValidMask2: u32,
    pub ulAspectRatioData2: u32,
    pub ulAspectRatioValidMask3: u32,
    pub ulAspectRatioData3: u32,
    pub ulReserved2: [u32; 4],
    pub ulReserved3: [u32; 4],
}

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

type OPM_RANDOM_NUMBER struct {
	abRandomNumber [16]byte
}

type OPM_ACP_AND_CGMSA_SIGNALING struct {
	rnRandomNumber OPM_RANDOM_NUMBER
	ulStatusFlags uint32
	ulAvailableTVProtectionStandards uint32
	ulActiveTVProtectionStandard uint32
	ulReserved uint32
	ulAspectRatioValidMask1 uint32
	ulAspectRatioData1 uint32
	ulAspectRatioValidMask2 uint32
	ulAspectRatioData2 uint32
	ulAspectRatioValidMask3 uint32
	ulAspectRatioData3 uint32
	ulReserved2 [4]uint32
	ulReserved3 [4]uint32
}

type
  OPM_RANDOM_NUMBER = record
    abRandomNumber: array[0..15] of Byte;
  end;

  OPM_ACP_AND_CGMSA_SIGNALING = packed record
    rnRandomNumber: OPM_RANDOM_NUMBER;
    ulStatusFlags: DWORD;
    ulAvailableTVProtectionStandards: DWORD;
    ulActiveTVProtectionStandard: DWORD;
    ulReserved: DWORD;
    ulAspectRatioValidMask1: DWORD;
    ulAspectRatioData1: DWORD;
    ulAspectRatioValidMask2: DWORD;
    ulAspectRatioData2: DWORD;
    ulAspectRatioValidMask3: DWORD;
    ulAspectRatioData3: DWORD;
    ulReserved2: array[0..3] of DWORD;
    ulReserved3: array[0..3] of DWORD;
  end;

const OPM_RANDOM_NUMBER = extern struct {
    abRandomNumber: [16]u8,
};

const OPM_ACP_AND_CGMSA_SIGNALING = extern struct {
    rnRandomNumber: OPM_RANDOM_NUMBER,
    ulStatusFlags: u32,
    ulAvailableTVProtectionStandards: u32,
    ulActiveTVProtectionStandard: u32,
    ulReserved: u32,
    ulAspectRatioValidMask1: u32,
    ulAspectRatioData1: u32,
    ulAspectRatioValidMask2: u32,
    ulAspectRatioData2: u32,
    ulAspectRatioValidMask3: u32,
    ulAspectRatioData3: u32,
    ulReserved2: [4]u32,
    ulReserved3: [4]u32,
};

type
  OPM_RANDOM_NUMBER {.bycopy.} = object
    abRandomNumber: array[16, uint8]

  OPM_ACP_AND_CGMSA_SIGNALING {.packed.} = object
    rnRandomNumber: OPM_RANDOM_NUMBER
    ulStatusFlags: uint32
    ulAvailableTVProtectionStandards: uint32
    ulActiveTVProtectionStandard: uint32
    ulReserved: uint32
    ulAspectRatioValidMask1: uint32
    ulAspectRatioData1: uint32
    ulAspectRatioValidMask2: uint32
    ulAspectRatioData2: uint32
    ulAspectRatioValidMask3: uint32
    ulAspectRatioData3: uint32
    ulReserved2: array[4, uint32]
    ulReserved3: array[4, uint32]

struct OPM_RANDOM_NUMBER
{
    ubyte[16] abRandomNumber;
}

align(1)
struct OPM_ACP_AND_CGMSA_SIGNALING
{
    OPM_RANDOM_NUMBER rnRandomNumber;
    uint ulStatusFlags;
    uint ulAvailableTVProtectionStandards;
    uint ulActiveTVProtectionStandard;
    uint ulReserved;
    uint ulAspectRatioValidMask1;
    uint ulAspectRatioData1;
    uint ulAspectRatioValidMask2;
    uint ulAspectRatioData2;
    uint ulAspectRatioValidMask3;
    uint ulAspectRatioData3;
    uint[4] ulReserved2;
    uint[4] ulReserved3;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OPM_ACP_AND_CGMSA_SIGNALING サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; rnRandomNumber : OPM_RANDOM_NUMBER (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; ulStatusFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ulAvailableTVProtectionStandards : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ulActiveTVProtectionStandard : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ulReserved : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ulAspectRatioValidMask1 : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ulAspectRatioData1 : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ulAspectRatioValidMask2 : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ulAspectRatioData2 : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ulAspectRatioValidMask3 : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ulAspectRatioData3 : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ulReserved2 : DWORD (+56, 16byte)  varptr(st)+56 を基点に操作(16byte:入れ子/配列)
; ulReserved3 : DWORD (+72, 16byte)  varptr(st)+72 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global OPM_RANDOM_NUMBER
    #field byte abRandomNumber 16
#endstruct

#defstruct global OPM_ACP_AND_CGMSA_SIGNALING, pack=1
    #field OPM_RANDOM_NUMBER rnRandomNumber
    #field int ulStatusFlags
    #field int ulAvailableTVProtectionStandards
    #field int ulActiveTVProtectionStandard
    #field int ulReserved
    #field int ulAspectRatioValidMask1
    #field int ulAspectRatioData1
    #field int ulAspectRatioValidMask2
    #field int ulAspectRatioData2
    #field int ulAspectRatioValidMask3
    #field int ulAspectRatioData3
    #field int ulReserved2 4
    #field int ulReserved3 4
#endstruct

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