NdisGetProcessorInformationEx function (ndis.h)

Article
10/21/2021

The NdisGetProcessorInformationEx function retrieves information about the CPU topology of the local computer.

Syntax

NDIS_STATUS NdisGetProcessorInformationEx(
  [in, optional]  NDIS_HANDLE                    NdisHandle,
  [out, optional] PNDIS_SYSTEM_PROCESSOR_INFO_EX SystemProcessorInfo,
  [in, out]       PSIZE_T                        Size
);

Parameters

[in, optional] NdisHandle

An NDIS driver or instance handle that was obtained during caller initialization. For example, a miniport driver can use the NDIS handle that it obtained from the NdisMRegisterMiniportDriver or MiniportInitializeEx functions. Other NDIS drivers can use the handles from the following functions:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[out, optional] SystemProcessorInfo

A pointer to a caller-allocated buffer where NDIS puts the NDIS_SYSTEM_PROCESSOR_INFO_EX structure and an array of NDIS_PROCESSOR_INFO_EX structures that contain information about the CPU topology of the local computer. The caller provides the length of the buffer in the Size parameter.

[in, out] Size

A pointer to a value that is the size, in bytes, of the buffer that the caller provided. When the function returns, this value contains either the amount of data that NDIS put in the buffer or the required size of the buffer if the buffer was too short.

Return value

NdisGetProcessorInformationEx can return one of the following status values:

Return code	Description
NDIS_STATUS_SUCCESS	The operation completed successfully.
NDIS_STATUS_BUFFER_TOO_SHORT	The size of the buffer at the Size parameter was too small. In this case, NDIS provides the required buffer size in the Size member.

Remarks

NDIS drivers call the NdisGetProcessorInformationEx function to retrieve information about the processors on the local computer.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.20 and later.
Target Platform	Universal
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL