- About Processes and Threads
- Controlling Processes and Threads
- Displaying Processes and Threads
- Setting the Current Process and Thread
- Freezing and Suspending Threads
- Threads and Processes in Other Commands
- Multiple Systems
- Process and Thread Functions
- Dispatch Queue Function
- Process Functions
- Process Enumeration Functions
- Policy Functions
- Thread Functions
- Process and Thread Extended Attribute Functions
- WOW64 Functions
- Job Object Functions
- Thread Pool Functions
- Thread Ordering Service Functions
- Multimedia Class Scheduler Service Functions
- Fiber Functions
- NUMA Support Functions
- Processor Functions
- User-Mode Scheduling Functions
About Processes and Threads
Each process provides the resources needed to execute a program. A process has a virtual address space, executable code, open handles to system objects, a security context, a unique process identifier, environment variables, a priority class, minimum and maximum working set sizes, and at least one thread of execution. Each process is started with a single thread, often called the primary thread, but can create additional threads from any of its threads.
A thread is the entity within a process that can be scheduled for execution. All threads of a process share its virtual address space and system resources. In addition, each thread maintains exception handlers, a scheduling priority, thread local storage, a unique thread identifier, and a set of structures the system will use to save the thread context until it is scheduled. The thread context includes the thread’s set of machine registers, the kernel stack, a thread environment block, and a user stack in the address space of the thread’s process. Threads can also have their own security context, which can be used for impersonating clients.
Microsoft Windows supports preemptive multitasking, which creates the effect of simultaneous execution of multiple threads from multiple processes. On a multiprocessor computer, the system can simultaneously execute as many threads as there are processors on the computer.
A job object allows groups of processes to be managed as a unit. Job objects are namable, securable, sharable objects that control attributes of the processes associated with them. Operations performed on the job object affect all processes associated with the job object.
An application can use the thread pool to reduce the number of application threads and provide management of the worker threads. Applications can queue work items, associate work with waitable handles, automatically queue based on a timer, and bind with I/O.
User-mode scheduling (UMS) is a lightweight mechanism that applications can use to schedule their own threads. An application can switch between UMS threads in user mode without involving the system scheduler and regain control of the processor if a UMS thread blocks in the kernel. Each UMS thread has its own thread context instead of sharing the thread context of a single thread. The ability to switch between threads in user mode makes UMS more efficient than thread pools for short-duration work items that require few system calls.
A fiber is a unit of execution that must be manually scheduled by the application. Fibers run in the context of the threads that schedule them. Each thread can schedule multiple fibers. In general, fibers do not provide advantages over a well-designed multithreaded application. However, using fibers can make it easier to port applications that were designed to schedule their own threads.
For more information, see the following topics:
Controlling Processes and Threads
When you are performing user-mode debugging, you activate, display, freeze, unfreeze, suspend, and unsuspend processes and threads.
The current or active process is the process that is currently being debugged. Similarly, the current or active thread is the thread that the debugger is currently controlling. The actions of many debugger commands are determined by the identity of the current process and thread. The current process also determines the virtual address mappings that the debugger uses.
When debugging begins, the current process is the one that the debugger is attached to or that caused the exception that broke into the debugger. Similarly, the current thread is the one that was active when the debugger attached to the process or that caused the exception. However, you can use the debugger to change the current process and thread and to freeze or unfreeze individual threads.
In kernel-mode debugging, processes and threads are not controlled by the methods that are described in this section. For more information about how processes and threads are manipulated in kernel mode, see Changing Contexts.
Displaying Processes and Threads
To display process and thread information, you can use the following methods:
Setting the Current Process and Thread
To change the current process or thread, you can use the following methods:
Freezing and Suspending Threads
The debugger can change the execution of a thread by suspending the thread or by freezing the thread. These two actions have somewhat different effects.
Each thread has a suspend count that is associated with it. If this count is one or larger, the system does not run the thread. If the count is zero or lower, the system runs the thread when appropriate.
Typically, each thread has a suspend count of zero. When the debugger attaches to a process, it increments the suspend counts of all threads in that process by one. If the debugger detaches from the process, it decrements all suspend counts by one. When the debugger executes the process, it temporarily decrements all suspend counts by one.
You can control the suspend count of any thread from the debugger by using the following methods:
n (Suspend Thread) command increments the specified thread’s suspend count by one.
m (Resume Thread) command decrements the specified thread’s suspend count by one.
The most common use for these commands is to raise a specific thread’s suspend count from one to two. When the debugger executes or detaches from the process, the thread then has a suspend count of one and remains suspended, even if other threads in the process are executing.
You can suspend threads even when you are performing noninvasive debugging.
The debugger can also freeze a thread. This action is similar to suspending the thread in some ways. However, «frozen» is only a debugger setting. Nothing in the Windows operating system recognizes that anything is different about this thread.
By default, all threads are unfrozen. When the debugger causes a process to execute, threads that are frozen do not execute. However, if the debugger detaches from the process, all threads unfreeze.
To freeze and unfreeze individual threads, you can use the following methods:
f (Freeze Thread) command freezes the specified thread.
u (Unfreeze Thread) command unfreezes the specified thread.
In any event, threads that belong to the target process never execute when the debugger has broken into the target. The suspend count of a thread affects the thread’s behavior only when the debugger executes the process or detaches. The frozen status affects the thread’s behavior only when the debugger executes the process.
Threads and Processes in Other Commands
You can add thread specifiers or process specifiers before many other commands. For more information, see the individual command topics.
You can add the
e (Thread-Specific Command) qualifier before many commands and extension commands. This qualifier causes the command to be executed with respect to the specified thread. This qualifier is especially useful if you want to apply a command to more than one thread. For example, the following command repeats the !gle extension command for every thread that is being debugged.
Multiple Systems
The debugger can attach to multiple targets at the same time. When these processes include dump files or include live targets on more than one computer, the debugger references a system, process, and thread for each action. For more information about this kind of debugging, see Debugging Multiple Targets.
Process and Thread Functions
This topic describes the process and thread functions.
Dispatch Queue Function
The following function creates a DispatcherQueueController.
Function | Description |
---|---|
CreateDispatcherQueueController | Creates a DispatcherQueueController which manages the lifetime of a DispatcherQueue that runs queued tasks in priority order on another thread. |
Process Functions
The following functions are used with processes.
Function | Description |
---|---|
CreateProcess | Creates a new process and its primary thread. |
CreateProcessAsUser | Creates a new process and its primary thread. The new process runs in the security context of the user represented by the specified token. |
CreateProcessWithLogonW | Creates a new process and its primary thread. The new process then runs the specified executable file in the security context of the specified credentials (user, domain, and password). |
CreateProcessWithTokenW | Creates a new process and its primary thread. The new process runs in the security context of the specified token. |
ExitProcess | Ends the calling process and all its threads. |
FlushProcessWriteBuffers | Flushes the write queue of each processor that is running a thread of the current process. |
FreeEnvironmentStrings | Frees a block of environment strings. |
GetCommandLine | Retrieves the command-line string for the current process. |
GetCurrentProcess | Retrieves a pseudo handle for the current process. |
GetCurrentProcessId | Retrieves the process identifier of the calling process. |
GetCurrentProcessorNumber | Retrieves the number of the processor the current thread was running on during the call to this function. |
GetEnvironmentStrings | Retrieves the environment block for the current process. |
GetEnvironmentVariable | Retrieves the value of the specified variable from the environment block of the calling process. |
GetExitCodeProcess | Retrieves the termination status of the specified process. |
GetGuiResources | Retrieves the count of handles to graphical user interface (GUI) objects in use by the specified process. |
GetLogicalProcessorInformation | Retrieves information about logical processors and related hardware. |
GetPriorityClass | Retrieves the priority class for the specified process. |
GetProcessAffinityMask | Retrieves a process affinity mask for the specified process and the system affinity mask for the system. |
GetProcessGroupAffinity | Retrieves the processor group affinity of the specified process. |
GetProcessHandleCount | Retrieves the number of open handles that belong to the specified process. |
GetProcessId | Retrieves the process identifier of the specified process. |
GetProcessIdOfThread | Retrieves the process identifier of the process associated with the specified thread. |
GetProcessIoCounters | Retrieves accounting information for all I/O operations performed by the specified process. |
GetProcessMitigationPolicy | Retrieves mitigation policy settings for the calling process. |
GetProcessPriorityBoost | Retrieves the priority boost control state of the specified process. |
GetProcessShutdownParameters | Retrieves shutdown parameters for the currently calling process. |
GetProcessTimes | Retrieves timing information about for the specified process. |
GetProcessVersion | Retrieves the major and minor version numbers of the system on which the specified process expects to run. |
GetProcessWorkingSetSize | Retrieves the minimum and maximum working set sizes of the specified process. |
GetProcessWorkingSetSizeEx | Retrieves the minimum and maximum working set sizes of the specified process. |
GetProcessorSystemCycleTime | Retrieves the cycle time each processor in the specified group spent executing deferred procedure calls (DPCs) and interrupt service routines (ISRs). |
GetStartupInfo | Retrieves the contents of the STARTUPINFO structure that was specified when the calling process was created. |
IsImmersiveProcess | Determines whether the process belongs to a Windows Store app. |
NeedCurrentDirectoryForExePath | Determines whether the current directory should be included in the search path for the specified executable. |
OpenProcess | Opens an existing local process object. |
QueryFullProcessImageName | Retrieves the full name of the executable image for the specified process. |
QueryProcessAffinityUpdateMode | Retrieves the affinity update mode of the specified process. |
QueryProcessCycleTime | Retrieves the sum of the cycle time of all threads of the specified process. |
SetEnvironmentVariable | Sets the value of an environment variable for the current process. |
SetPriorityClass | Sets the priority class for the specified process. |
SetProcessAffinityMask | Sets a processor affinity mask for the threads of a specified process. |
SetProcessAffinityUpdateMode | Sets the affinity update mode of the specified process. |
SetProcessInformation | Sets information for the specified process. |
SetProcessMitigationPolicy | Sets the mitigation policy for the calling process. |
SetProcessPriorityBoost | Disables the ability of the system to temporarily boost the priority of the threads of the specified process. |
SetProcessRestrictionExemption | Exempts the calling process from restrictions preventing desktop processes from interacting with the Windows Store app environment. This function is used by development and debugging tools. |
SetProcessShutdownParameters | Sets shutdown parameters for the currently calling process. |
SetProcessWorkingSetSize | Sets the minimum and maximum working set sizes for the specified process. |
SetProcessWorkingSetSizeEx | Sets the minimum and maximum working set sizes for the specified process. |
TerminateProcess | Terminates the specified process and all of its threads. |
Process Enumeration Functions
The following functions are used to enumerate processes.
Function | Description |
---|---|
EnumProcesses | Retrieves the process identifier for each process object in the system. |
Process32First | Retrieves information about the first process encountered in a system snapshot. |
Process32Next | Retrieves information about the next process recorded in a system snapshot. |
WTSEnumerateProcesses | Retrieves information about the active processes on the specified terminal server. |
Policy Functions
The following functions are used with process wide policy.
Function | Description |
QueryProtectedPolicy | Queries the value associated with a protected policy. |
SetProtectedPolicy | Sets a protected policy. |
Thread Functions
The following functions are used with threads.
Function | Description |
---|---|
AttachThreadInput | Attaches the input processing mechanism of one thread to that of another thread. |
CreateRemoteThread | Creates a thread that runs in the virtual address space of another process. |
CreateRemoteThreadEx | Creates a thread that runs in the virtual address space of another process and optionally specifies extended attributes such as processor group affinity. |
CreateThread | Creates a thread to execute within the virtual address space of the calling process. |
ExitThread | Ends the calling thread. |
GetCurrentThread | Retrieves a pseudo handle for the current thread. |
GetCurrentThreadId | Retrieves the thread identifier of the calling thread. |
GetExitCodeThread | Retrieves the termination status of the specified thread. |
GetThreadDescription | Retrieves the description that was assigned to a thread by calling SetThreadDescription. |
GetThreadGroupAffinity | Retrieves the processor group affinity of the specified thread. |
GetThreadId | Retrieves the thread identifier of the specified thread. |
GetThreadIdealProcessorEx | Retrieves the processor number of the ideal processor for the specified thread. |
GetThreadInformation | Retrieves information about the specified thread. |
GetThreadIOPendingFlag | Determines whether a specified thread has any I/O requests pending. |
GetThreadPriority | Retrieves the priority value for the specified thread. |
GetThreadPriorityBoost | Retrieves the priority boost control state of the specified thread. |
GetThreadTimes | Retrieves timing information for the specified thread. |
OpenThread | Opens an existing thread object. |
QueryIdleProcessorCycleTime | Retrieves the cycle time for the idle thread of each processor in the system. |
QueryThreadCycleTime | Retrieves the cycle time for the specified thread. |
ResumeThread | Decrements a thread’s suspend count. |
SetThreadAffinityMask | Sets a processor affinity mask for the specified thread. |
SetThreadDescription | Assigns a description to a thread. |
SetThreadGroupAffinity | Sets the processor group affinity for the specified thread. |
SetThreadIdealProcessor | Specifies a preferred processor for a thread. |
SetThreadIdealProcessorEx | Sets the ideal processor for the specified thread and optionally retrieves the previous ideal processor. |
SetThreadInformation | Sets information for the specified thread. |
SetThreadPriority | Sets the priority value for the specified thread. |
SetThreadPriorityBoost | Disables the ability of the system to temporarily boost the priority of a thread. |
SetThreadStackGuarantee | Sets the stack guarantee for the calling thread. |
Sleep | Suspends the execution of the current thread for a specified interval. |
SleepEx | Suspends the current thread until the specified condition is met. |
SuspendThread | Suspends the specified thread. |
SwitchToThread | Causes the calling thread to yield execution to another thread that is ready to run on the current processor. |
TerminateThread | Terminates a thread. |
ThreadProc | An application-defined function that serves as the starting address for a thread. |
TlsAlloc | Allocates a thread local storage (TLS) index. |
TlsFree | Releases a TLS index. |
TlsGetValue | Retrieves the value in the calling thread’s TLS slot for a specified TLS index. |
TlsSetValue | Stores a value in the calling thread’s TLS slot for a specified TLS index. |
WaitForInputIdle | Waits until the specified process is waiting for user input with no input pending, or until the time-out interval has elapsed. |
Process and Thread Extended Attribute Functions
The following functions are used to set extended attributes for process and thread creation.
Function | Description |
---|---|
DeleteProcThreadAttributeList | Deletes the specified list of attributes for process and thread creation. |
InitializeProcThreadAttributeList | Initializes the specified list of attributes for process and thread creation. |
UpdateProcThreadAttribute | Updates the specified attribute in the specified list of attributes for process and thread creation. |
WOW64 Functions
The following functions are used with WOW64.
Function | Description |
---|---|
IsWow64Message | Determines whether the last message read from the current thread’s queue originated from a WOW64 process. |
IsWow64Process | Determines whether the specified process is running under WOW64. |
IsWow64Process2 | Determines whether the specified process is running under WOW64; also returns additional machine process and architecture information. |
Wow64SuspendThread | Suspends the specified WOW64 thread. |
Job Object Functions
The following functions are used with job objects.
Function | Description |
---|---|
AssignProcessToJobObject | Associates a process with an existing job object. |
CreateJobObject | Creates or opens a job object. |
IsProcessInJob | Determines whether the process is running in the specified job. |
OpenJobObject | Opens an existing job object. |
QueryInformationJobObject | Retrieves limit and job state information from the job object. |
SetInformationJobObject | Set limits for a job object. |
TerminateJobObject | Terminates all processes currently associated with the job. |
UserHandleGrantAccess | Grants or denies access to a handle to a User object to a job that has a user-interface restriction. |
Thread Pool Functions
The following functions are used with thread pools.
Function | Description |
---|---|
CallbackMayRunLong | Indicates that the callback may not return quickly. |
CancelThreadpoolIo | Cancels the notification from the StartThreadpoolIo function. |
CloseThreadpool | Closes the specified thread pool. |
CloseThreadpoolCleanupGroup | Closes the specified cleanup group. |
CloseThreadpoolCleanupGroupMembers | Releases the members of the specified cleanup group, waits for all callback functions to complete, and optionally cancels any outstanding callback functions. |
CloseThreadpoolIo | Releases the specified I/O completion object. |
CloseThreadpoolTimer | Releases the specified timer object. |
CloseThreadpoolWait | Releases the specified wait object. |
CloseThreadpoolWork | Releases the specified work object. |
CreateThreadpool | Allocates a new pool of threads to execute callbacks. |
CreateThreadpoolCleanupGroup | Creates a cleanup group that applications can use to track one or more thread pool callbacks. |
CreateThreadpoolIo | Creates a new I/O completion object. |
CreateThreadpoolTimer | Creates a new timer object. |
CreateThreadpoolWait | Creates a new wait object. |
CreateThreadpoolWork | Creates a new work object. |
DestroyThreadpoolEnvironment | Deletes the specified callback environment. Call this function when the callback environment is no longer needed for creating new thread pool objects. |
DisassociateCurrentThreadFromCallback | Removes the association between the currently executing callback function and the object that initiated the callback. The current thread will no longer count as executing a callback on behalf of the object. |
FreeLibraryWhenCallbackReturns | Specifies the DLL that the thread pool will unload when the current callback completes. |
InitializeThreadpoolEnvironment | Initializes a callback environment. |
IsThreadpoolTimerSet | Determines whether the specified timer object is currently set. |
LeaveCriticalSectionWhenCallbackReturns | Specifies the critical section that the thread pool will release when the current callback completes. |
QueryThreadpoolStackInformation | Retrieves the stack reserve and commit sizes for threads in the specified thread pool. |
ReleaseMutexWhenCallbackReturns | Specifies the mutex that the thread pool will release when the current callback completes. |
ReleaseSemaphoreWhenCallbackReturns | Specifies the semaphore that the thread pool will release when the current callback completes. |
SetEventWhenCallbackReturns | Specifies the event that the thread pool will set when the current callback completes. |
SetThreadpoolCallbackCleanupGroup | Associates the specified cleanup group with the specified callback environment. |
SetThreadpoolCallbackLibrary | Ensures that the specified DLL remains loaded as long as there are outstanding callbacks. |
SetThreadpoolCallbackPersistent | Specifies that the callback should run on a persistent thread. |
SetThreadpoolCallbackPool | Sets the thread pool to be used when generating callbacks. |
SetThreadpoolCallbackPriority | Specifies the priority of a callback function relative to other work items in the same thread pool. |
SetThreadpoolCallbackRunsLong | Indicates that callbacks associated with this callback environment may not return quickly. |
SetThreadpoolStackInformation | Sets the stack reserve and commit sizes for new threads in the specified thread pool. |
SetThreadpoolThreadMaximum | Sets the maximum number of threads that the specified thread pool can allocate to process callbacks. |
SetThreadpoolThreadMinimum | Sets the minimum number of threads that the specified thread pool must make available to process callbacks. |
SetThreadpoolTimerEx | Sets the timer object. A worker thread calls the timer object’s callback after the specified timeout expires. |
SetThreadpoolTimer | Sets the timer object. A worker thread calls the timer object’s callback after the specified timeout expires. |
SetThreadpoolWait | Sets the wait object. A worker thread calls the wait object’s callback function after the handle becomes signaled or after the specified timeout expires. |
SetThreadpoolWaitEx | Sets the wait object. A worker thread calls the wait object’s callback function after the handle becomes signaled or after the specified timeout expires. |
StartThreadpoolIo | Notifies the thread pool that I/O operations may possibly begin for the specified I/O completion object. A worker thread calls the I/O completion object’s callback function after the operation completes on the file handle bound to this object. |
SubmitThreadpoolWork | Posts a work object to the thread pool. A worker thread calls the work object’s callback function. |
TpInitializeCallbackEnviron | Initializes a callback environment for the thread pool. |
TpDestroyCallbackEnviron | Deletes the specified callback environment. Call this function when the callback environment is no longer needed for creating new thread pool objects. |
TpSetCallbackActivationContext | Assigns an activation context to the callback environment. |
TpSetCallbackCleanupGroup | Associates the specified cleanup group with the specified callback environment. |
TpSetCallbackFinalizationCallback | Indicates a function to call when the callback environment is finalized. |
TpSetCallbackLongFunction | Indicates that callbacks associated with this callback environment may not return quickly. |
TpSetCallbackNoActivationContext | Indicates that the callback environment has no activation context. |
TpSetCallbackPersistent | Specifies that the callback should run on a persistent thread. |
TpSetCallbackPriority | Specifies the priority of a callback function relative to other work items in the same thread pool. |
TpSetCallbackRaceWithDll | Ensures that the specified DLL remains loaded as long as there are outstanding callbacks. |
TpSetCallbackThreadpool | Assigns a thread pool to a callback environment. |
TrySubmitThreadpoolCallback | Requests that a thread pool worker thread call the specified callback function. |
WaitForThreadpoolIoCallbacks | Waits for outstanding I/O completion callbacks to complete and optionally cancels pending callbacks that have not yet started to execute. |
WaitForThreadpoolTimerCallbacks | Waits for outstanding timer callbacks to complete and optionally cancels pending callbacks that have not yet started to execute. |
WaitForThreadpoolWaitCallbacks | Waits for outstanding wait callbacks to complete and optionally cancels pending callbacks that have not yet started to execute. |
WaitForThreadpoolWorkCallbacks | Waits for outstanding work callbacks to complete and optionally cancels pending callbacks that have not yet started to execute. |
The following functions are part of the original thread pooling API.
Function | Description |
---|---|
BindIoCompletionCallback | Associates the I/O completion port owned by the thread pool with the specified file handle. On completion of an I/O request involving this file, a non-I/O worker thread will execute the specified callback function. |
QueueUserWorkItem | Queues a work item to a worker thread in the thread pool. |
RegisterWaitForSingleObject | Directs a wait thread in the thread pool to wait on the object. |
UnregisterWaitEx | Waits until one or all of the specified objects are in the signaled state or the time-out interval elapses. |
Thread Ordering Service Functions
The following functions are used with the thread ordering service.
Function | Description |
---|---|
AvQuerySystemResponsiveness | Retrieves the system responsiveness setting used by the multimedia class scheduler service. |
AvRtCreateThreadOrderingGroup | Creates a thread ordering group. |
AvRtCreateThreadOrderingGroupEx | Creates a thread ordering group and associates the server thread with a task. |
AvRtDeleteThreadOrderingGroup | Deletes the specified thread ordering group created by the caller. |
AvRtJoinThreadOrderingGroup | Joins client threads to a thread ordering group. |
AvRtLeaveThreadOrderingGroup | Enables client threads to leave a thread ordering group. |
AvRtWaitOnThreadOrderingGroup | Enables client threads of a thread ordering group to wait until they should execute. |
Multimedia Class Scheduler Service Functions
The following functions are used with the multimedia class scheduler service.
Function | Description |
---|---|
AvRevertMmThreadCharacteristics | Indicates that a thread is no longer performing work associated with the specified task. |
AvSetMmMaxThreadCharacteristics | Associates the calling thread with the specified tasks. |
AvSetMmThreadCharacteristics | Associates the calling thread with the specified task. |
AvSetMmThreadPriority | Adjusts the thread priority of the calling thread relative to other threads performing the same task. |
Fiber Functions
The following functions are used with fibers.
Function | Description |
---|---|
ConvertFiberToThread | Converts the current fiber into a thread. |
ConvertThreadToFiber | Converts the current thread into a fiber. |
ConvertThreadToFiberEx | Converts the current thread into a fiber. |
CreateFiber | Allocates a fiber object, assigns it a stack, and sets up execution to begin at the specified start address. |
CreateFiberEx | Allocates a fiber object, assigns it a stack, and sets up execution to begin at the specified start address. |
DeleteFiber | Deletes an existing fiber. |
FiberProc | An application-defined function used with the CreateFiber function. |
FlsAlloc | Allocates a fiber local storage (FLS) index. |
FlsFree | Releases an FLS index. |
FlsGetValue | Retrieves the value in the calling fiber’s FLS slot for a specified FLS index. |
FlsSetValue | Stores a value in the calling fiber’s FLS slot for a specified FLS index. |
IsThreadAFiber | Determines whether the current thread is a fiber. |
SwitchToFiber | Schedules a fiber. |
NUMA Support Functions
The following functions provide NUMA support.
Function | Description |
---|---|
AllocateUserPhysicalPagesNuma | Reserves or commits a region of memory within the virtual address space of the specified process, and specifies the NUMA node for the physical memory. |
GetLogicalProcessorInformation | Retrieves information about logical processors and related hardware. |
GetNumaAvailableMemoryNode | Retrieves the amount of memory available in the specified node. |
GetNumaAvailableMemoryNodeEx | Retrieves the amount of memory that is available in the specified node as a USHORT value. |
GetNumaHighestNodeNumber | Retrieves the node that currently has the highest number. |
GetNumaNodeNumberFromHandle | Retrieves the NUMA node associated with the underlying device for a file handle. |
GetNumaNodeProcessorMask | Retrieves the processor mask for the specified node. |
GetNumaNodeProcessorMaskEx | Retrieves the processor mask for the specified NUMA node as a USHORT value. |
GetNumaProcessorNode | Retrieves the node number for the specified processor. |
GetNumaProcessorNodeEx | Retrieves the node number of the specified logical processor as a USHORT value. |
GetNumaProximityNode | Retrieves the node number for the specified proximity identifier. |
GetNumaProximityNodeEx | Retrieves the node number as a USHORT value for the specified proximity identifier. |
VirtualAllocExNuma | Reserves or commits a region of memory within the virtual address space of the specified process, and specifies the NUMA node for the physical memory. |
Processor Functions
The following functions are used with logical processors and processor groups.
Function | Description |
---|---|
GetActiveProcessorCount | Returns the number of active processors in a processor group or in the system. |
GetActiveProcessorGroupCount | Returns the number of active processor groups in the system. |
GetCurrentProcessorNumber | Retrieves the number of the processor the current thread was running on during the call to this function. |
GetCurrentProcessorNumberEx | Retrieves the processor group and number of the logical processor in which the calling thread is running. |
GetLogicalProcessorInformation | Retrieves information about logical processors and related hardware. |
GetLogicalProcessorInformationEx | Retrieves information about the relationships of logical processors and related hardware. |
GetMaximumProcessorCount | Returns the maximum number of logical processors that a processor group or the system can have. |
GetMaximumProcessorGroupCount | Returns the maximum number of processor groups that the system can have. |
QueryIdleProcessorCycleTime | Retrieves the cycle time for the idle thread of each processor in the system. |
QueryIdleProcessorCycleTimeEx | Retrieves the accumulated cycle time for the idle thread on each logical processor in the specified processor group. |
User-Mode Scheduling Functions
The following functions are used with user-mode scheduling (UMS).