Win32 API 日本語リファレンス
ホーム › Graphics.Dxgi › DXGI_OUTDUPL_POINTER_SHAPE_INFO

DXGI_OUTDUPL_POINTER_SHAPE_INFO

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

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

フィールド

フィールド型サイズx64x86説明
TypeDWORD4+0+0カーソル形状の種類を指定する DXGI_OUTDUPL_POINTER_SHAPE_TYPE 型の値です。
WidthDWORD4+4+4マウスカーソルの幅 (ピクセル単位) です。
HeightDWORD4+8+8マウスカーソルの高さ (走査線単位) です。
PitchDWORD4+12+12マウスカーソルの幅 (バイト単位) です。
HotSpotPOINT8+16+16左上のピクセルを基準とした、カーソルのホットスポットの位置です。アプリケーションは、カーソル形状を描画する位置を決定する際にホットスポットを使用しません。

公式ドキュメント

DXGI_OUTDUPL_POINTER_SHAPE_INFO 構造体は、カーソルの形状に関する情報を記述します。

解説(Remarks)

アプリケーションは、DXGI_OUTDUPL_POINTER_POSITION 構造体の Position メンバーが指定する位置に左上隅が来るようにカーソル形状を描画します。カーソル形状の描画にホットスポットは使用しません。

アプリケーションは IDXGIOutputDuplication::GetFramePointerShape メソッドを呼び出して、DXGI_OUTDUPL_POINTER_SHAPE_INFO 構造体に格納されたカーソル形状の情報を取得します。

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

各言語での定義

#include <windows.h>

// POINT  (x64 8 / x86 8 バイト)
typedef struct POINT {
    INT x;
    INT y;
} POINT;

// DXGI_OUTDUPL_POINTER_SHAPE_INFO  (x64 24 / x86 24 バイト)
typedef struct DXGI_OUTDUPL_POINTER_SHAPE_INFO {
    DWORD Type;
    DWORD Width;
    DWORD Height;
    DWORD Pitch;
    POINT HotSpot;
} DXGI_OUTDUPL_POINTER_SHAPE_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct POINT
{
    public int x;
    public int y;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXGI_OUTDUPL_POINTER_SHAPE_INFO
{
    public uint Type;
    public uint Width;
    public uint Height;
    public uint Pitch;
    public POINT HotSpot;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure POINT
    Public x As Integer
    Public y As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXGI_OUTDUPL_POINTER_SHAPE_INFO
    Public Type As UInteger
    Public Width As UInteger
    Public Height As UInteger
    Public Pitch As UInteger
    Public HotSpot As POINT
End Structure
import ctypes
from ctypes import wintypes

class POINT(ctypes.Structure):
    _fields_ = [
        ("x", ctypes.c_int),
        ("y", ctypes.c_int),
    ]

class DXGI_OUTDUPL_POINTER_SHAPE_INFO(ctypes.Structure):
    _fields_ = [
        ("Type", wintypes.DWORD),
        ("Width", wintypes.DWORD),
        ("Height", wintypes.DWORD),
        ("Pitch", wintypes.DWORD),
        ("HotSpot", POINT),
    ]
#[repr(C)]
pub struct POINT {
    pub x: i32,
    pub y: i32,
}

#[repr(C)]
pub struct DXGI_OUTDUPL_POINTER_SHAPE_INFO {
    pub Type: u32,
    pub Width: u32,
    pub Height: u32,
    pub Pitch: u32,
    pub HotSpot: POINT,
}
import "golang.org/x/sys/windows"

type POINT struct {
	x int32
	y int32
}

type DXGI_OUTDUPL_POINTER_SHAPE_INFO struct {
	Type uint32
	Width uint32
	Height uint32
	Pitch uint32
	HotSpot POINT
}
type
  POINT = record
    x: Integer;
    y: Integer;
  end;

  DXGI_OUTDUPL_POINTER_SHAPE_INFO = record
    Type: DWORD;
    Width: DWORD;
    Height: DWORD;
    Pitch: DWORD;
    HotSpot: POINT;
  end;
const POINT = extern struct {
    x: i32,
    y: i32,
};

const DXGI_OUTDUPL_POINTER_SHAPE_INFO = extern struct {
    Type: u32,
    Width: u32,
    Height: u32,
    Pitch: u32,
    HotSpot: POINT,
};
type
  POINT {.bycopy.} = object
    x: int32
    y: int32

  DXGI_OUTDUPL_POINTER_SHAPE_INFO {.bycopy.} = object
    Type: uint32
    Width: uint32
    Height: uint32
    Pitch: uint32
    HotSpot: POINT
struct POINT
{
    int x;
    int y;
}

struct DXGI_OUTDUPL_POINTER_SHAPE_INFO
{
    uint Type;
    uint Width;
    uint Height;
    uint Pitch;
    POINT HotSpot;
}

HSP用 定義

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

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

#defstruct global DXGI_OUTDUPL_POINTER_SHAPE_INFO
    #field int Type
    #field int Width
    #field int Height
    #field int Pitch
    #field POINT HotSpot
#endstruct

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