NdisGetProcessorInformationEx function (ndis.h)

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

See also

FilterAttach

MiniportInitializeEx

NDIS_SYSTEM_PROCESSOR_INFO_EX

NdisFRegisterFilterDriver

NdisMRegisterMiniportDriver

NdisOpenAdapterEx

NdisRegisterProtocolDriver