DXVA_COPPSetSignalingCmdData
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| ActiveTVProtectionStandard | DWORD | 4 | +0 | +0 | 現在アクティブな保護標準と形式を指定します。値は COPP_TVProtectionStandard 列挙型のメンバーです。 |
| AspectRatioChangeMask1 | DWORD | 4 | +4 | +4 | AspectRatioData1 のどのビットを信号に設定するかを示すビットマスクです。 |
| AspectRatioData1 | DWORD | 4 | +8 | +8 | 現在の保護標準に対して設定するアスペクト比の値を指定します。EN 300 294 の場合は COPP_ImageAspectRatio_EN300294 列挙型を使用します。 |
| AspectRatioChangeMask2 | DWORD | 4 | +12 | +12 | AspectRatioData2 のどのビットを信号に設定するかを示すビットマスクです。 |
| AspectRatioData2 | DWORD | 4 | +16 | +16 | アスペクト比に関連する追加のデータ要素です。このデータの有無と意味は保護標準によって異なります。このフィールドは、EIA-608-B の End ビットおよび Q0 ビット、または CEA-805-A のアクティブ フォーマット ディスクリプションを伝えるために使用できます。 |
| AspectRatioChangeMask3 | DWORD | 4 | +20 | +20 | AspectRatioData3 のどのビットを信号に設定するかを示すビットマスクです。 |
| AspectRatioData3 | DWORD | 4 | +24 | +24 | 現在の保護標準におけるアスペクト比に関連する追加のデータ要素です。このデータの有無と意味は保護標準によって異なります。 |
| ExtendedInfoChangeMask | DWORD | 16 | +28 | +28 | ExtendedInfoData のどのビットを変更するかを示すビットマスクの配列です。この配列は現在使用されていません。各メンバーを 0 に設定してください。 |
| ExtendedInfoData | DWORD | 16 | +44 | +44 | 設定する追加のシグナリング要素です。この配列は現在使用されていません。 各メンバーを 0 に設定してください。 |
| Reserved | DWORD | 4 | +60 | +60 | 予約済みです。0 に設定してください。 |
公式ドキュメント
[このページに関連する機能である 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) の Set Signal コマンドに関する情報を格納します。
このコマンドは、一部の 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 行目に挿入されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DXVA_COPPSetSignalingCmdData (x64 64 / x86 64 バイト)
typedef struct DXVA_COPPSetSignalingCmdData {
DWORD ActiveTVProtectionStandard;
DWORD AspectRatioChangeMask1;
DWORD AspectRatioData1;
DWORD AspectRatioChangeMask2;
DWORD AspectRatioData2;
DWORD AspectRatioChangeMask3;
DWORD AspectRatioData3;
DWORD ExtendedInfoChangeMask[4];
DWORD ExtendedInfoData[4];
DWORD Reserved;
} DXVA_COPPSetSignalingCmdData;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXVA_COPPSetSignalingCmdData
{
public uint ActiveTVProtectionStandard;
public uint AspectRatioChangeMask1;
public uint AspectRatioData1;
public uint AspectRatioChangeMask2;
public uint AspectRatioData2;
public uint AspectRatioChangeMask3;
public uint AspectRatioData3;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] ExtendedInfoChangeMask;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] ExtendedInfoData;
public uint Reserved;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXVA_COPPSetSignalingCmdData
Public ActiveTVProtectionStandard As UInteger
Public AspectRatioChangeMask1 As UInteger
Public AspectRatioData1 As UInteger
Public AspectRatioChangeMask2 As UInteger
Public AspectRatioData2 As UInteger
Public AspectRatioChangeMask3 As UInteger
Public AspectRatioData3 As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public ExtendedInfoChangeMask() As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public ExtendedInfoData() As UInteger
Public Reserved As UInteger
End Structureimport ctypes
from ctypes import wintypes
class DXVA_COPPSetSignalingCmdData(ctypes.Structure):
_fields_ = [
("ActiveTVProtectionStandard", wintypes.DWORD),
("AspectRatioChangeMask1", wintypes.DWORD),
("AspectRatioData1", wintypes.DWORD),
("AspectRatioChangeMask2", wintypes.DWORD),
("AspectRatioData2", wintypes.DWORD),
("AspectRatioChangeMask3", wintypes.DWORD),
("AspectRatioData3", wintypes.DWORD),
("ExtendedInfoChangeMask", wintypes.DWORD * 4),
("ExtendedInfoData", wintypes.DWORD * 4),
("Reserved", wintypes.DWORD),
]#[repr(C)]
pub struct DXVA_COPPSetSignalingCmdData {
pub ActiveTVProtectionStandard: u32,
pub AspectRatioChangeMask1: u32,
pub AspectRatioData1: u32,
pub AspectRatioChangeMask2: u32,
pub AspectRatioData2: u32,
pub AspectRatioChangeMask3: u32,
pub AspectRatioData3: u32,
pub ExtendedInfoChangeMask: [u32; 4],
pub ExtendedInfoData: [u32; 4],
pub Reserved: u32,
}import "golang.org/x/sys/windows"
type DXVA_COPPSetSignalingCmdData struct {
ActiveTVProtectionStandard uint32
AspectRatioChangeMask1 uint32
AspectRatioData1 uint32
AspectRatioChangeMask2 uint32
AspectRatioData2 uint32
AspectRatioChangeMask3 uint32
AspectRatioData3 uint32
ExtendedInfoChangeMask [4]uint32
ExtendedInfoData [4]uint32
Reserved uint32
}type
DXVA_COPPSetSignalingCmdData = record
ActiveTVProtectionStandard: DWORD;
AspectRatioChangeMask1: DWORD;
AspectRatioData1: DWORD;
AspectRatioChangeMask2: DWORD;
AspectRatioData2: DWORD;
AspectRatioChangeMask3: DWORD;
AspectRatioData3: DWORD;
ExtendedInfoChangeMask: array[0..3] of DWORD;
ExtendedInfoData: array[0..3] of DWORD;
Reserved: DWORD;
end;const DXVA_COPPSetSignalingCmdData = extern struct {
ActiveTVProtectionStandard: u32,
AspectRatioChangeMask1: u32,
AspectRatioData1: u32,
AspectRatioChangeMask2: u32,
AspectRatioData2: u32,
AspectRatioChangeMask3: u32,
AspectRatioData3: u32,
ExtendedInfoChangeMask: [4]u32,
ExtendedInfoData: [4]u32,
Reserved: u32,
};type
DXVA_COPPSetSignalingCmdData {.bycopy.} = object
ActiveTVProtectionStandard: uint32
AspectRatioChangeMask1: uint32
AspectRatioData1: uint32
AspectRatioChangeMask2: uint32
AspectRatioData2: uint32
AspectRatioChangeMask3: uint32
AspectRatioData3: uint32
ExtendedInfoChangeMask: array[4, uint32]
ExtendedInfoData: array[4, uint32]
Reserved: uint32struct DXVA_COPPSetSignalingCmdData
{
uint ActiveTVProtectionStandard;
uint AspectRatioChangeMask1;
uint AspectRatioData1;
uint AspectRatioChangeMask2;
uint AspectRatioData2;
uint AspectRatioChangeMask3;
uint AspectRatioData3;
uint[4] ExtendedInfoChangeMask;
uint[4] ExtendedInfoData;
uint Reserved;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DXVA_COPPSetSignalingCmdData サイズ: 64 バイト(x64)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; ActiveTVProtectionStandard : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; AspectRatioChangeMask1 : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; AspectRatioData1 : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; AspectRatioChangeMask2 : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; AspectRatioData2 : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; AspectRatioChangeMask3 : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; AspectRatioData3 : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ExtendedInfoChangeMask : DWORD (+28, 16byte) varptr(st)+28 を基点に操作(16byte:入れ子/配列)
; ExtendedInfoData : DWORD (+44, 16byte) varptr(st)+44 を基点に操作(16byte:入れ子/配列)
; Reserved : DWORD (+60, 4byte) st.15 = 値 / 値 = st.15 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DXVA_COPPSetSignalingCmdData
#field int ActiveTVProtectionStandard
#field int AspectRatioChangeMask1
#field int AspectRatioData1
#field int AspectRatioChangeMask2
#field int AspectRatioData2
#field int AspectRatioChangeMask3
#field int AspectRatioData3
#field int ExtendedInfoChangeMask 4
#field int ExtendedInfoData 4
#field int Reserved
#endstruct
stdim st, DXVA_COPPSetSignalingCmdData ; NSTRUCT 変数を確保
st->ActiveTVProtectionStandard = 100
mes "ActiveTVProtectionStandard=" + st->ActiveTVProtectionStandard