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

2025-02-07

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

[in, out] Size

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

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

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

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

Замечания

Драйверы NDIS вызывают функцию NdisGetProcessorInformationEx для получения сведений об процессорах на локальном компьютере.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.20 и более поздних версиях.
целевая платформа	Всеобщий
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	<= DISPATCH_LEVEL