Функция NdisGetProcessorInformationEx (ndis.h)

Статья
02/29/2024

Функция NdisGetProcessorInformationEx извлекает сведения о топологии ЦП локального компьютера.

Синтаксис

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 структур, содержащих сведения о топологии ЦП локального компьютера. Вызывающий объект предоставляет длину буфера в параметре Size .

[in, out] Size

Указатель на значение, представляющее размер (в байтах) буфера, предоставленного вызывающим объектом. При возврате функции это значение содержит либо объем данных, которые NDIS помещает в буфер, либо требуемый размер буфера, если буфер был слишком коротким.

Возвращаемое значение

NdisGetProcessorInformationEx может возвращать одно из следующих значений состояния:

Код возврата	Описание
NDIS_STATUS_SUCCESS	Операция выполнена успешно.
NDIS_STATUS_BUFFER_TOO_SHORT	Размер буфера в параметре Size был слишком мал. В этом случае NDIS предоставляет требуемый размер буфера в элементе Size .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.20 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL