NdisGetProcessorInformationEx 函数 (ndis.h)

项目
02/29/2024

NdisGetProcessorInformationEx 函数检索有关本地计算机的 CPU 拓扑的信息。

语法

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

参数

[in, optional] NdisHandle

在调用方初始化期间获取的 NDIS 驱动程序或实例句柄。例如，微型端口驱动程序可以使用它从获取的 NDIS 句柄 NdisMRegisterMiniportDriver 或 MiniportInitializeEx 函数。其他 NDIS 驱动程序可以使用以下函数中的句柄：

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[out, optional] SystemProcessorInfo

指向调用方分配的缓冲区的指针，NDIS 在其中放置 NDIS_SYSTEM_PROCESSOR_INFO_EX 结构和包含有关本地计算机的 CPU 拓扑信息的 NDIS_PROCESSOR_INFO_EX 结构数组。调用方在 Size 参数中提供缓冲区的长度。

[in, out] Size

指向值的指针，该值是调用方提供的缓冲区的大小（以字节为单位）。当函数返回时，此值包含 NDIS 放入缓冲区中的数据量，或者包含缓冲区的所需大小（如果缓冲区太短）。

返回值

NdisGetProcessorInformationEx 可以返回以下状态值之一：

返回代码	说明
NDIS_STATUS_SUCCESS	操作已成功完成。
NDIS_STATUS_BUFFER_TOO_SHORT	Size 参数处的缓冲区大小太小。在这种情况下，NDIS 在 Size 成员中提供所需的缓冲区大小。

注解

NDIS 驱动程序调用 NdisGetProcessorInformationEx 函数以检索有关本地计算机上的处理器的信息。

要求

要求	值
最低受支持的客户端	在 NDIS 6.20 及更高版本中受支持。
目标平台	通用
标头	ndis.h (包括 Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL