ホーム › Media.MediaFoundation › OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS

OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
ulNewTVProtectionStandard	DWORD	4	+0	+0	現在有効な保護規格と形式を指定します。値は TV Protection Standard Flags のビット単位の OR です。
ulAspectRatioChangeMask1	DWORD	4	+4	+4	ulAspectRatioData1 のどのビットを信号に設定するかを示すビットマスクです。
ulAspectRatioData1	DWORD	4	+8	+8	現在の保護規格に対して設定するアスペクト比の値を指定します。EN 300 294 の場合は OPM_IMAGE_ASPECT_RATIO_EN300294 列挙型を使用します。
ulAspectRatioChangeMask2	DWORD	4	+12	+12	ulAspectRatioData2 のどのビットを信号に設定するかを示すビットマスクです。
ulAspectRatioData2	DWORD	4	+16	+16	アスペクト比に関連する追加のデータ要素です。このデータの有無と意味は保護規格によって異なります。このフィールドは、EIA-608-B の End ビットおよび Q0 ビットや、CEA-805-A のアクティブフォーマットディスクリプションを伝えるために使用できます。
ulAspectRatioChangeMask3	DWORD	4	+20	+20	ulAspectRatioData3 のどのビットを信号に設定するかを示すビットマスクです。
ulAspectRatioData3	DWORD	4	+24	+24	現在の保護規格におけるアスペクト比に関連する追加のデータ要素です。このデータの有無と意味は保護規格によって異なります。
ulReserved	DWORD	16	+28	+28	将来の使用のために予約済みです。配列全体を 0 に設定してください。
ulReserved2	DWORD	16	+44	+44	将来の使用のために予約済みです。配列全体を 0 に設定してください。
ulReserved3	DWORD	4	+60	+60	将来の使用のために予約済みです。0 に設定してください。

公式ドキュメント

Output Protection Manager (OPM) の OPM_SET_ACP_AND_CGMSA_SIGNALING コマンドの情報を格納します。

このコマンドにより、ドライバーは一部の Analog Copy Protection (ACP) 仕様や Copy Generation Management System — Analog (CGMS-A) 仕様で要求されるとおり、ワイドスクリーンシグナリング (WSS) コードやその他のデータパケットをテレビ信号に挿入します。例:

ETSI EN 300 294 (625i PAL): データパケットは信号の 23 行目に挿入されます。
CEA-608-B (NTSC): データパケットは垂直帰線期間 (VBI) の 21 行目に挿入されます。

解説(Remarks)

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

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

各言語での定義

#include <windows.h>

// OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS  (x64 64 / x86 64 バイト)
#pragma pack(push, 1)
typedef struct OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS {
    DWORD ulNewTVProtectionStandard;
    DWORD ulAspectRatioChangeMask1;
    DWORD ulAspectRatioData1;
    DWORD ulAspectRatioChangeMask2;
    DWORD ulAspectRatioData2;
    DWORD ulAspectRatioChangeMask3;
    DWORD ulAspectRatioData3;
    DWORD ulReserved[4];
    DWORD ulReserved2[4];
    DWORD ulReserved3;
} OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS
{
    public uint ulNewTVProtectionStandard;
    public uint ulAspectRatioChangeMask1;
    public uint ulAspectRatioData1;
    public uint ulAspectRatioChangeMask2;
    public uint ulAspectRatioData2;
    public uint ulAspectRatioChangeMask3;
    public uint ulAspectRatioData3;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] ulReserved;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] ulReserved2;
    public uint ulReserved3;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS
    Public ulNewTVProtectionStandard As UInteger
    Public ulAspectRatioChangeMask1 As UInteger
    Public ulAspectRatioData1 As UInteger
    Public ulAspectRatioChangeMask2 As UInteger
    Public ulAspectRatioData2 As UInteger
    Public ulAspectRatioChangeMask3 As UInteger
    Public ulAspectRatioData3 As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public ulReserved() As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public ulReserved2() As UInteger
    Public ulReserved3 As UInteger
End Structure

import ctypes
from ctypes import wintypes

class OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("ulNewTVProtectionStandard", wintypes.DWORD),
        ("ulAspectRatioChangeMask1", wintypes.DWORD),
        ("ulAspectRatioData1", wintypes.DWORD),
        ("ulAspectRatioChangeMask2", wintypes.DWORD),
        ("ulAspectRatioData2", wintypes.DWORD),
        ("ulAspectRatioChangeMask3", wintypes.DWORD),
        ("ulAspectRatioData3", wintypes.DWORD),
        ("ulReserved", wintypes.DWORD * 4),
        ("ulReserved2", wintypes.DWORD * 4),
        ("ulReserved3", wintypes.DWORD),
    ]

#[repr(C, packed(1))]
pub struct OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS {
    pub ulNewTVProtectionStandard: u32,
    pub ulAspectRatioChangeMask1: u32,
    pub ulAspectRatioData1: u32,
    pub ulAspectRatioChangeMask2: u32,
    pub ulAspectRatioData2: u32,
    pub ulAspectRatioChangeMask3: u32,
    pub ulAspectRatioData3: u32,
    pub ulReserved: [u32; 4],
    pub ulReserved2: [u32; 4],
    pub ulReserved3: u32,
}

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

type OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS struct {
	ulNewTVProtectionStandard uint32
	ulAspectRatioChangeMask1 uint32
	ulAspectRatioData1 uint32
	ulAspectRatioChangeMask2 uint32
	ulAspectRatioData2 uint32
	ulAspectRatioChangeMask3 uint32
	ulAspectRatioData3 uint32
	ulReserved [4]uint32
	ulReserved2 [4]uint32
	ulReserved3 uint32
}

type
  OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS = packed record
    ulNewTVProtectionStandard: DWORD;
    ulAspectRatioChangeMask1: DWORD;
    ulAspectRatioData1: DWORD;
    ulAspectRatioChangeMask2: DWORD;
    ulAspectRatioData2: DWORD;
    ulAspectRatioChangeMask3: DWORD;
    ulAspectRatioData3: DWORD;
    ulReserved: array[0..3] of DWORD;
    ulReserved2: array[0..3] of DWORD;
    ulReserved3: DWORD;
  end;

const OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS = extern struct {
    ulNewTVProtectionStandard: u32,
    ulAspectRatioChangeMask1: u32,
    ulAspectRatioData1: u32,
    ulAspectRatioChangeMask2: u32,
    ulAspectRatioData2: u32,
    ulAspectRatioChangeMask3: u32,
    ulAspectRatioData3: u32,
    ulReserved: [4]u32,
    ulReserved2: [4]u32,
    ulReserved3: u32,
};

type
  OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS {.packed.} = object
    ulNewTVProtectionStandard: uint32
    ulAspectRatioChangeMask1: uint32
    ulAspectRatioData1: uint32
    ulAspectRatioChangeMask2: uint32
    ulAspectRatioData2: uint32
    ulAspectRatioChangeMask3: uint32
    ulAspectRatioData3: uint32
    ulReserved: array[4, uint32]
    ulReserved2: array[4, uint32]
    ulReserved3: uint32

align(1)
struct OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS
{
    uint ulNewTVProtectionStandard;
    uint ulAspectRatioChangeMask1;
    uint ulAspectRatioData1;
    uint ulAspectRatioChangeMask2;
    uint ulAspectRatioData2;
    uint ulAspectRatioChangeMask3;
    uint ulAspectRatioData3;
    uint[4] ulReserved;
    uint[4] ulReserved2;
    uint 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_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; ulNewTVProtectionStandard : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulAspectRatioChangeMask1 : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ulAspectRatioData1 : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ulAspectRatioChangeMask2 : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ulAspectRatioData2 : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ulAspectRatioChangeMask3 : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ulAspectRatioData3 : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ulReserved : DWORD (+28, 16byte)  varptr(st)+28 を基点に操作(16byte:入れ子/配列)
; ulReserved2 : DWORD (+44, 16byte)  varptr(st)+44 を基点に操作(16byte:入れ子/配列)
; ulReserved3 : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS, pack=1
    #field int ulNewTVProtectionStandard
    #field int ulAspectRatioChangeMask1
    #field int ulAspectRatioData1
    #field int ulAspectRatioChangeMask2
    #field int ulAspectRatioData2
    #field int ulAspectRatioChangeMask3
    #field int ulAspectRatioData3
    #field int ulReserved 4
    #field int ulReserved2 4
    #field int ulReserved3
#endstruct

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