NdisGetProcessorInformationEx 函式 (ndis.h)

發行項
03/01/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 結構和 NDIS_PROCESSOR_INFO_EX 結構的陣列，其中包含本機計算機的CPU拓撲相關信息。呼叫端會在 Size 參數中提供緩衝區的長度。

[in, out] Size

值指標，其大小為呼叫端提供的緩衝區大小，以位元組為單位。當函式傳回時，這個值會包含 NDIS 放入緩衝區的數據量，如果緩衝區太短，則為緩衝區所需的大小。

傳回值

NdisGetProcessorInformationEx 可以傳回下列其中一個狀態值：

傳回碼	Description
NDIS_STATUS_SUCCESS	作業已成功完成。
NDIS_STATUS_BUFFER_TOO_SHORT	Size 參數的緩衝區大小太小。在此情況下，NDIS 會在 Size 成員中提供必要的緩衝區大小。

備註

NDIS 驅動程式會呼叫 NdisGetProcessorInformationEx 函式，以擷取本機電腦上的處理器相關信息。

規格需求

需求	值
最低支援的用戶端	NDIS 6.20 和更新版本支援。
目標平台	Universal
標頭	ndis.h (包含 Ndis.h)
程式庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL