Export (0) Print
Expand All
IRP
MDL
Expand Minimize
This topic has not yet been rated - Rate this topic

PROCESSOR_NUMBER structure

The PROCESSOR_NUMBER structure identifies a processor by its group number and group-relative processor number.

Syntax


typedef struct _PROCESSOR_NUMBER {
  USHORT Group;
  UCHAR  Number;
  UCHAR  Reserved;
} PROCESSOR_NUMBER, *PPROCESSOR_NUMBER;

Members

Group

The group number. If multiprocessor system contains n groups, the groups are numbered from 0 to n-1.

Number

The group-relative processor number. If a group contains m logical processors, the processors are numbered from 0 to m-1.

Reserved

Reserved for future use. Initialize to zero.

Remarks

Windows 7 is the first version of Windows to support processor groups. In Windows 7, only 64-bit versions of Windows support multiple groups; 32-bit versions of Windows support only one group. If a multiprocessor system is running a 64-bit version of Windows and contains no more than 64 logical processors, Windows assigns all processors to group 0. A multiprocessor system that is running a 32-bit version of Windows can contain no more than 32 processors.

In Windows 7, the maximum number of groups in a multiprocessor system is four, but this value might change in future versions of Windows. The safest way to determine the maximum number of groups in Windows 7 or a later version of Windows is to call the KeQueryMaximumGroupCount routine. Kernel-mode drivers that call KeQueryMaximumGroupCount will not require code changes if the formula that is used to calculate the maximum number of groups changes in a future version of Windows.

Kernel-mode routines that use the PROCESSOR_NUMBER structure include KeGetCurrentProcessorNumberEx, KeGetProcessorIndexFromNumber, KeGetProcessorNumberFromIndex, and KeQueryLogicalProcessorRelationship.

Requirements

Version

Supported in Windows 7 and later versions of the Windows operating system.

Header

Winnt.h (include Windows.h);
Ntdef.h (include Wdm.h or Ntddk.h)

See also

KeGetCurrentProcessorNumberEx
KeGetProcessorIndexFromNumber
KeGetProcessorNumberFromIndex
KeQueryLogicalProcessorRelationship
KeQueryMaximumGroupCount

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.