Win32 API 日本語リファレンス
ホームUI.ColorSystem › CheckBitmapBits

CheckBitmapBits

関数
ビットマップ各画素が色域内にあるか確認する。
DLLmscms.dll呼出規約winapi

シグネチャ

// mscms.dll
#include <windows.h>

BOOL CheckBitmapBits(
    INT_PTR hColorTransform,
    void* pSrcBits,
    BMFORMAT bmInput,
    DWORD dwWidth,
    DWORD dwHeight,
    DWORD dwStride,
    BYTE* paResult,
    LPBMCALLBACKFN pfnCallback,   // optional
    LPARAM lpCallbackData   // optional
);

パラメーター

名前方向
hColorTransformINT_PTRin
pSrcBitsvoid*in
bmInputBMFORMATin
dwWidthDWORDin
dwHeightDWORDin
dwStrideDWORDin
paResultBYTE*out
pfnCallbackLPBMCALLBACKFNinoptional
lpCallbackDataLPARAMinoptional

戻り値の型: BOOL

各言語での呼び出し定義

// mscms.dll
#include <windows.h>

BOOL CheckBitmapBits(
    INT_PTR hColorTransform,
    void* pSrcBits,
    BMFORMAT bmInput,
    DWORD dwWidth,
    DWORD dwHeight,
    DWORD dwStride,
    BYTE* paResult,
    LPBMCALLBACKFN pfnCallback,   // optional
    LPARAM lpCallbackData   // optional
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("mscms.dll", ExactSpelling = true)]
static extern bool CheckBitmapBits(
    IntPtr hColorTransform,   // INT_PTR
    IntPtr pSrcBits,   // void*
    int bmInput,   // BMFORMAT
    uint dwWidth,   // DWORD
    uint dwHeight,   // DWORD
    uint dwStride,   // DWORD
    IntPtr paResult,   // BYTE* out
    IntPtr pfnCallback,   // LPBMCALLBACKFN optional
    IntPtr lpCallbackData   // LPARAM optional
);
<DllImport("mscms.dll", ExactSpelling:=True)>
Public Shared Function CheckBitmapBits(
    hColorTransform As IntPtr,   ' INT_PTR
    pSrcBits As IntPtr,   ' void*
    bmInput As Integer,   ' BMFORMAT
    dwWidth As UInteger,   ' DWORD
    dwHeight As UInteger,   ' DWORD
    dwStride As UInteger,   ' DWORD
    paResult As IntPtr,   ' BYTE* out
    pfnCallback As IntPtr,   ' LPBMCALLBACKFN optional
    lpCallbackData As IntPtr   ' LPARAM optional
) As Boolean
End Function
' hColorTransform : INT_PTR
' pSrcBits : void*
' bmInput : BMFORMAT
' dwWidth : DWORD
' dwHeight : DWORD
' dwStride : DWORD
' paResult : BYTE* out
' pfnCallback : LPBMCALLBACKFN optional
' lpCallbackData : LPARAM optional
Declare PtrSafe Function CheckBitmapBits Lib "mscms" ( _
    ByVal hColorTransform As LongPtr, _
    ByVal pSrcBits As LongPtr, _
    ByVal bmInput As Long, _
    ByVal dwWidth As Long, _
    ByVal dwHeight As Long, _
    ByVal dwStride As Long, _
    ByVal paResult As LongPtr, _
    ByVal pfnCallback As LongPtr, _
    ByVal lpCallbackData As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CheckBitmapBits = ctypes.windll.mscms.CheckBitmapBits
CheckBitmapBits.restype = wintypes.BOOL
CheckBitmapBits.argtypes = [
    ctypes.c_ssize_t,  # hColorTransform : INT_PTR
    ctypes.POINTER(None),  # pSrcBits : void*
    ctypes.c_int,  # bmInput : BMFORMAT
    wintypes.DWORD,  # dwWidth : DWORD
    wintypes.DWORD,  # dwHeight : DWORD
    wintypes.DWORD,  # dwStride : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # paResult : BYTE* out
    ctypes.c_void_p,  # pfnCallback : LPBMCALLBACKFN optional
    ctypes.c_ssize_t,  # lpCallbackData : LPARAM optional
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('mscms.dll')
CheckBitmapBits = Fiddle::Function.new(
  lib['CheckBitmapBits'],
  [
    Fiddle::TYPE_INTPTR_T,  # hColorTransform : INT_PTR
    Fiddle::TYPE_VOIDP,  # pSrcBits : void*
    Fiddle::TYPE_INT,  # bmInput : BMFORMAT
    -Fiddle::TYPE_INT,  # dwWidth : DWORD
    -Fiddle::TYPE_INT,  # dwHeight : DWORD
    -Fiddle::TYPE_INT,  # dwStride : DWORD
    Fiddle::TYPE_VOIDP,  # paResult : BYTE* out
    Fiddle::TYPE_VOIDP,  # pfnCallback : LPBMCALLBACKFN optional
    Fiddle::TYPE_INTPTR_T,  # lpCallbackData : LPARAM optional
  ],
  Fiddle::TYPE_INT)
#[link(name = "mscms")]
extern "system" {
    fn CheckBitmapBits(
        hColorTransform: isize,  // INT_PTR
        pSrcBits: *mut (),  // void*
        bmInput: i32,  // BMFORMAT
        dwWidth: u32,  // DWORD
        dwHeight: u32,  // DWORD
        dwStride: u32,  // DWORD
        paResult: *mut u8,  // BYTE* out
        pfnCallback: *const core::ffi::c_void,  // LPBMCALLBACKFN optional
        lpCallbackData: isize  // LPARAM optional
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("mscms.dll")]
public static extern bool CheckBitmapBits(IntPtr hColorTransform, IntPtr pSrcBits, int bmInput, uint dwWidth, uint dwHeight, uint dwStride, IntPtr paResult, IntPtr pfnCallback, IntPtr lpCallbackData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'mscms_CheckBitmapBits' -Namespace Win32 -PassThru
# $api::CheckBitmapBits(hColorTransform, pSrcBits, bmInput, dwWidth, dwHeight, dwStride, paResult, pfnCallback, lpCallbackData)
#uselib "mscms.dll"
#func global CheckBitmapBits "CheckBitmapBits" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; CheckBitmapBits hColorTransform, pSrcBits, bmInput, dwWidth, dwHeight, dwStride, varptr(paResult), pfnCallback, lpCallbackData   ; 戻り値は stat
; hColorTransform : INT_PTR -> "sptr"
; pSrcBits : void* -> "sptr"
; bmInput : BMFORMAT -> "sptr"
; dwWidth : DWORD -> "sptr"
; dwHeight : DWORD -> "sptr"
; dwStride : DWORD -> "sptr"
; paResult : BYTE* out -> "sptr"
; pfnCallback : LPBMCALLBACKFN optional -> "sptr"
; lpCallbackData : LPARAM optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "mscms.dll"
#cfunc global CheckBitmapBits "CheckBitmapBits" sptr, sptr, int, int, int, int, var, sptr, sptr
; res = CheckBitmapBits(hColorTransform, pSrcBits, bmInput, dwWidth, dwHeight, dwStride, paResult, pfnCallback, lpCallbackData)
; hColorTransform : INT_PTR -> "sptr"
; pSrcBits : void* -> "sptr"
; bmInput : BMFORMAT -> "int"
; dwWidth : DWORD -> "int"
; dwHeight : DWORD -> "int"
; dwStride : DWORD -> "int"
; paResult : BYTE* out -> "var"
; pfnCallback : LPBMCALLBACKFN optional -> "sptr"
; lpCallbackData : LPARAM optional -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; BOOL CheckBitmapBits(INT_PTR hColorTransform, void* pSrcBits, BMFORMAT bmInput, DWORD dwWidth, DWORD dwHeight, DWORD dwStride, BYTE* paResult, LPBMCALLBACKFN pfnCallback, LPARAM lpCallbackData)
#uselib "mscms.dll"
#cfunc global CheckBitmapBits "CheckBitmapBits" intptr, intptr, int, int, int, int, var, intptr, intptr
; res = CheckBitmapBits(hColorTransform, pSrcBits, bmInput, dwWidth, dwHeight, dwStride, paResult, pfnCallback, lpCallbackData)
; hColorTransform : INT_PTR -> "intptr"
; pSrcBits : void* -> "intptr"
; bmInput : BMFORMAT -> "int"
; dwWidth : DWORD -> "int"
; dwHeight : DWORD -> "int"
; dwStride : DWORD -> "int"
; paResult : BYTE* out -> "var"
; pfnCallback : LPBMCALLBACKFN optional -> "intptr"
; lpCallbackData : LPARAM optional -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	mscms = windows.NewLazySystemDLL("mscms.dll")
	procCheckBitmapBits = mscms.NewProc("CheckBitmapBits")
)

// hColorTransform (INT_PTR), pSrcBits (void*), bmInput (BMFORMAT), dwWidth (DWORD), dwHeight (DWORD), dwStride (DWORD), paResult (BYTE* out), pfnCallback (LPBMCALLBACKFN optional), lpCallbackData (LPARAM optional)
r1, _, err := procCheckBitmapBits.Call(
	uintptr(hColorTransform),
	uintptr(pSrcBits),
	uintptr(bmInput),
	uintptr(dwWidth),
	uintptr(dwHeight),
	uintptr(dwStride),
	uintptr(paResult),
	uintptr(pfnCallback),
	uintptr(lpCallbackData),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function CheckBitmapBits(
  hColorTransform: NativeInt;   // INT_PTR
  pSrcBits: Pointer;   // void*
  bmInput: Integer;   // BMFORMAT
  dwWidth: DWORD;   // DWORD
  dwHeight: DWORD;   // DWORD
  dwStride: DWORD;   // DWORD
  paResult: Pointer;   // BYTE* out
  pfnCallback: Pointer;   // LPBMCALLBACKFN optional
  lpCallbackData: NativeInt   // LPARAM optional
): BOOL; stdcall;
  external 'mscms.dll' name 'CheckBitmapBits';
result := DllCall("mscms\CheckBitmapBits"
    , "Ptr", hColorTransform   ; INT_PTR
    , "Ptr", pSrcBits   ; void*
    , "Int", bmInput   ; BMFORMAT
    , "UInt", dwWidth   ; DWORD
    , "UInt", dwHeight   ; DWORD
    , "UInt", dwStride   ; DWORD
    , "Ptr", paResult   ; BYTE* out
    , "Ptr", pfnCallback   ; LPBMCALLBACKFN optional
    , "Ptr", lpCallbackData   ; LPARAM optional
    , "Int")   ; return: BOOL
●CheckBitmapBits(hColorTransform, pSrcBits, bmInput, dwWidth, dwHeight, dwStride, paResult, pfnCallback, lpCallbackData) = DLL("mscms.dll", "bool CheckBitmapBits(int, void*, int, dword, dword, dword, void*, void*, int)")
# 呼び出し: CheckBitmapBits(hColorTransform, pSrcBits, bmInput, dwWidth, dwHeight, dwStride, paResult, pfnCallback, lpCallbackData)
# hColorTransform : INT_PTR -> "int"
# pSrcBits : void* -> "void*"
# bmInput : BMFORMAT -> "int"
# dwWidth : DWORD -> "dword"
# dwHeight : DWORD -> "dword"
# dwStride : DWORD -> "dword"
# paResult : BYTE* out -> "void*"
# pfnCallback : LPBMCALLBACKFN optional -> "void*"
# lpCallbackData : LPARAM optional -> "int"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。