Export (0) Print
Expand All
Expand Minimize

KeQueryMaximumGroupCount routine

The KeQueryMaximumGroupCount routine returns the maximum number of groups in a multiprocessor system.

Syntax


USHORT KeQueryMaximumGroupCount(void);

Parameters

This routine has no parameters.

Return value

KeQueryMaximumGroupCount returns the maximum number of groups.

Remarks

The value that is returned by KeQueryMaximumGroupCount remains constant during runtime. This value depends on the hardware configuration of the multiprocessor system, but it can never exceed a fixed limit that is set by the Windows operating system.

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 versions of the Windows operating system is to call KeQueryMaximumGroupCount. 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.

To obtain the number of active groups in a multiprocessor system, call the KeQueryActiveGroupCount routine.

Requirements

Version

Available in Windows 7 and later versions of Windows.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

Any level

See also

KeQueryActiveGroupCount

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft