Win32 API 日本語リファレンス
ホームSystem.Threading › SetThreadGroupAffinity

SetThreadGroupAffinity

関数
スレッドのグループアフィニティを設定する。
DLLKERNEL32.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

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

BOOL SetThreadGroupAffinity(
    HANDLE hThread,
    const GROUP_AFFINITY* GroupAffinity,
    GROUP_AFFINITY* PreviousGroupAffinity   // optional
);

パラメーター

名前方向
hThreadHANDLEin
GroupAffinityGROUP_AFFINITY*in
PreviousGroupAffinityGROUP_AFFINITY*outoptional

戻り値の型: BOOL

各言語での呼び出し定義

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

BOOL SetThreadGroupAffinity(
    HANDLE hThread,
    const GROUP_AFFINITY* GroupAffinity,
    GROUP_AFFINITY* PreviousGroupAffinity   // optional
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll", ExactSpelling = true)]
static extern bool SetThreadGroupAffinity(
    IntPtr hThread,   // HANDLE
    IntPtr GroupAffinity,   // GROUP_AFFINITY*
    IntPtr PreviousGroupAffinity   // GROUP_AFFINITY* optional, out
);
<DllImport("KERNEL32.dll", ExactSpelling:=True)>
Public Shared Function SetThreadGroupAffinity(
    hThread As IntPtr,   ' HANDLE
    GroupAffinity As IntPtr,   ' GROUP_AFFINITY*
    PreviousGroupAffinity As IntPtr   ' GROUP_AFFINITY* optional, out
) As Boolean
End Function
' hThread : HANDLE
' GroupAffinity : GROUP_AFFINITY*
' PreviousGroupAffinity : GROUP_AFFINITY* optional, out
Declare PtrSafe Function SetThreadGroupAffinity Lib "kernel32" ( _
    ByVal hThread As LongPtr, _
    ByVal GroupAffinity As LongPtr, _
    ByVal PreviousGroupAffinity As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

SetThreadGroupAffinity = ctypes.windll.kernel32.SetThreadGroupAffinity
SetThreadGroupAffinity.restype = wintypes.BOOL
SetThreadGroupAffinity.argtypes = [
    wintypes.HANDLE,  # hThread : HANDLE
    ctypes.c_void_p,  # GroupAffinity : GROUP_AFFINITY*
    ctypes.c_void_p,  # PreviousGroupAffinity : GROUP_AFFINITY* optional, out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('KERNEL32.dll')
SetThreadGroupAffinity = Fiddle::Function.new(
  lib['SetThreadGroupAffinity'],
  [
    Fiddle::TYPE_VOIDP,  # hThread : HANDLE
    Fiddle::TYPE_VOIDP,  # GroupAffinity : GROUP_AFFINITY*
    Fiddle::TYPE_VOIDP,  # PreviousGroupAffinity : GROUP_AFFINITY* optional, out
  ],
  Fiddle::TYPE_INT)
#[link(name = "kernel32")]
extern "system" {
    fn SetThreadGroupAffinity(
        hThread: *mut core::ffi::c_void,  // HANDLE
        GroupAffinity: *const GROUP_AFFINITY,  // GROUP_AFFINITY*
        PreviousGroupAffinity: *mut GROUP_AFFINITY  // GROUP_AFFINITY* optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll")]
public static extern bool SetThreadGroupAffinity(IntPtr hThread, IntPtr GroupAffinity, IntPtr PreviousGroupAffinity);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_SetThreadGroupAffinity' -Namespace Win32 -PassThru
# $api::SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity)
#uselib "KERNEL32.dll"
#func global SetThreadGroupAffinity "SetThreadGroupAffinity" sptr, sptr, sptr
; SetThreadGroupAffinity hThread, varptr(GroupAffinity), varptr(PreviousGroupAffinity)   ; 戻り値は stat
; hThread : HANDLE -> "sptr"
; GroupAffinity : GROUP_AFFINITY* -> "sptr"
; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "KERNEL32.dll"
#cfunc global SetThreadGroupAffinity "SetThreadGroupAffinity" sptr, var, var
; res = SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity)
; hThread : HANDLE -> "sptr"
; GroupAffinity : GROUP_AFFINITY* -> "var"
; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; BOOL SetThreadGroupAffinity(HANDLE hThread, GROUP_AFFINITY* GroupAffinity, GROUP_AFFINITY* PreviousGroupAffinity)
#uselib "KERNEL32.dll"
#cfunc global SetThreadGroupAffinity "SetThreadGroupAffinity" intptr, var, var
; res = SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity)
; hThread : HANDLE -> "intptr"
; GroupAffinity : GROUP_AFFINITY* -> "var"
; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
	procSetThreadGroupAffinity = kernel32.NewProc("SetThreadGroupAffinity")
)

// hThread (HANDLE), GroupAffinity (GROUP_AFFINITY*), PreviousGroupAffinity (GROUP_AFFINITY* optional, out)
r1, _, err := procSetThreadGroupAffinity.Call(
	uintptr(hThread),
	uintptr(GroupAffinity),
	uintptr(PreviousGroupAffinity),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function SetThreadGroupAffinity(
  hThread: THandle;   // HANDLE
  GroupAffinity: Pointer;   // GROUP_AFFINITY*
  PreviousGroupAffinity: Pointer   // GROUP_AFFINITY* optional, out
): BOOL; stdcall;
  external 'KERNEL32.dll' name 'SetThreadGroupAffinity';
result := DllCall("KERNEL32\SetThreadGroupAffinity"
    , "Ptr", hThread   ; HANDLE
    , "Ptr", GroupAffinity   ; GROUP_AFFINITY*
    , "Ptr", PreviousGroupAffinity   ; GROUP_AFFINITY* optional, out
    , "Int")   ; return: BOOL
●SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity) = DLL("KERNEL32.dll", "bool SetThreadGroupAffinity(void*, void*, void*)")
# 呼び出し: SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity)
# hThread : HANDLE -> "void*"
# GroupAffinity : GROUP_AFFINITY* -> "void*"
# PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。