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

KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK

構造体
サイズx64: 52 バイト / x86: 52 バイト

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

フィールド

フィールドサイズx64x86説明
HeaderKSCAMERA_METADATA_ITEMHEADER8+0+0メタデータ項目の共通ヘッダKSCAMERA_METADATA_ITEMHEADER。
MaskCoverageBoundingBoxRECT16+8+8マスクが覆う範囲の境界矩形を表すRECT。
MaskResolutionSIZE8+24+24マスクデータの解像度を表すSIZE。
ForegroundBoundingBoxRECT16+32+32前景(人物等)の境界矩形を表すRECT。
MaskDataBYTE1+48+48マスクデータ本体の先頭バイト(可変長配列)。

各言語での定義

#include <windows.h>

// KSCAMERA_METADATA_ITEMHEADER  (x64 8 / x86 8 バイト)
typedef struct KSCAMERA_METADATA_ITEMHEADER {
    DWORD MetadataId;
    DWORD Size;
} KSCAMERA_METADATA_ITEMHEADER;

// RECT  (x64 16 / x86 16 バイト)
typedef struct RECT {
    INT left;
    INT top;
    INT right;
    INT bottom;
} RECT;

// SIZE  (x64 8 / x86 8 バイト)
typedef struct SIZE {
    INT cx;
    INT cy;
} SIZE;

// KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK  (x64 52 / x86 52 バイト)
typedef struct KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {
    KSCAMERA_METADATA_ITEMHEADER Header;
    RECT MaskCoverageBoundingBox;
    SIZE MaskResolution;
    RECT ForegroundBoundingBox;
    BYTE MaskData[1];
} KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSCAMERA_METADATA_ITEMHEADER
{
    public uint MetadataId;
    public uint Size;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RECT
{
    public int left;
    public int top;
    public int right;
    public int bottom;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SIZE
{
    public int cx;
    public int cy;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK
{
    public KSCAMERA_METADATA_ITEMHEADER Header;
    public RECT MaskCoverageBoundingBox;
    public SIZE MaskResolution;
    public RECT ForegroundBoundingBox;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public byte[] MaskData;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSCAMERA_METADATA_ITEMHEADER
    Public MetadataId As UInteger
    Public Size As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RECT
    Public left As Integer
    Public top As Integer
    Public right As Integer
    Public bottom As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SIZE
    Public cx As Integer
    Public cy As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK
    Public Header As KSCAMERA_METADATA_ITEMHEADER
    Public MaskCoverageBoundingBox As RECT
    Public MaskResolution As SIZE
    Public ForegroundBoundingBox As RECT
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public MaskData() As Byte
End Structure
import ctypes
from ctypes import wintypes

class KSCAMERA_METADATA_ITEMHEADER(ctypes.Structure):
    _fields_ = [
        ("MetadataId", wintypes.DWORD),
        ("Size", wintypes.DWORD),
    ]

class RECT(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_int),
        ("top", ctypes.c_int),
        ("right", ctypes.c_int),
        ("bottom", ctypes.c_int),
    ]

class SIZE(ctypes.Structure):
    _fields_ = [
        ("cx", ctypes.c_int),
        ("cy", ctypes.c_int),
    ]

class KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK(ctypes.Structure):
    _fields_ = [
        ("Header", KSCAMERA_METADATA_ITEMHEADER),
        ("MaskCoverageBoundingBox", RECT),
        ("MaskResolution", SIZE),
        ("ForegroundBoundingBox", RECT),
        ("MaskData", ctypes.c_ubyte * 1),
    ]
#[repr(C)]
pub struct KSCAMERA_METADATA_ITEMHEADER {
    pub MetadataId: u32,
    pub Size: u32,
}

#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct SIZE {
    pub cx: i32,
    pub cy: i32,
}

#[repr(C)]
pub struct KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {
    pub Header: KSCAMERA_METADATA_ITEMHEADER,
    pub MaskCoverageBoundingBox: RECT,
    pub MaskResolution: SIZE,
    pub ForegroundBoundingBox: RECT,
    pub MaskData: [u8; 1],
}
import "golang.org/x/sys/windows"

type KSCAMERA_METADATA_ITEMHEADER struct {
	MetadataId uint32
	Size uint32
}

type RECT struct {
	left int32
	top int32
	right int32
	bottom int32
}

type SIZE struct {
	cx int32
	cy int32
}

type KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK struct {
	Header KSCAMERA_METADATA_ITEMHEADER
	MaskCoverageBoundingBox RECT
	MaskResolution SIZE
	ForegroundBoundingBox RECT
	MaskData [1]byte
}
type
  KSCAMERA_METADATA_ITEMHEADER = record
    MetadataId: DWORD;
    Size: DWORD;
  end;

  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  SIZE = record
    cx: Integer;
    cy: Integer;
  end;

  KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK = record
    Header: KSCAMERA_METADATA_ITEMHEADER;
    MaskCoverageBoundingBox: RECT;
    MaskResolution: SIZE;
    ForegroundBoundingBox: RECT;
    MaskData: array[0..0] of Byte;
  end;
const KSCAMERA_METADATA_ITEMHEADER = extern struct {
    MetadataId: u32,
    Size: u32,
};

const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const SIZE = extern struct {
    cx: i32,
    cy: i32,
};

const KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK = extern struct {
    Header: KSCAMERA_METADATA_ITEMHEADER,
    MaskCoverageBoundingBox: RECT,
    MaskResolution: SIZE,
    ForegroundBoundingBox: RECT,
    MaskData: [1]u8,
};
type
  KSCAMERA_METADATA_ITEMHEADER {.bycopy.} = object
    MetadataId: uint32
    Size: uint32

  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  SIZE {.bycopy.} = object
    cx: int32
    cy: int32

  KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {.bycopy.} = object
    Header: KSCAMERA_METADATA_ITEMHEADER
    MaskCoverageBoundingBox: RECT
    MaskResolution: SIZE
    ForegroundBoundingBox: RECT
    MaskData: array[1, uint8]
struct KSCAMERA_METADATA_ITEMHEADER
{
    uint MetadataId;
    uint Size;
}

struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct SIZE
{
    int cx;
    int cy;
}

struct KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK
{
    KSCAMERA_METADATA_ITEMHEADER Header;
    RECT MaskCoverageBoundingBox;
    SIZE MaskResolution;
    RECT ForegroundBoundingBox;
    ubyte[1] MaskData;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK サイズ: 52 バイト(x64)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; Header : KSCAMERA_METADATA_ITEMHEADER (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; MaskCoverageBoundingBox : RECT (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; MaskResolution : SIZE (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ForegroundBoundingBox : RECT (+32, 16byte)  varptr(st)+32 を基点に操作(16byte:入れ子/配列)
; MaskData : BYTE (+48, 1byte)  varptr(st)+48 を基点に操作(1byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global KSCAMERA_METADATA_ITEMHEADER
    #field int MetadataId
    #field int Size
#endstruct

#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global SIZE
    #field int cx
    #field int cy
#endstruct

#defstruct global KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK
    #field KSCAMERA_METADATA_ITEMHEADER Header
    #field RECT MaskCoverageBoundingBox
    #field SIZE MaskResolution
    #field RECT ForegroundBoundingBox
    #field byte MaskData 1
#endstruct

stdim st, KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK        ; NSTRUCT 変数を確保