Função NdisGetProcessorInformationEx (ndis.h)

Artigo
03/05/2024

A função NdisGetProcessorInformationEx recupera informações sobre a topologia da CPU do computador local.

Sintaxe

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

Parâmetros

[in, optional] NdisHandle

Um identificador de instância ou driver NDIS que foi obtido durante a inicialização do chamador. Por exemplo, um driver de miniporte pode usar o identificador NDIS obtido do Funções NdisMRegisterMiniportDriver ou MiniportInitializeEx . Outros drivers NDIS podem usar os identificadores das seguintes funções:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[out, optional] SystemProcessorInfo

Um ponteiro para um buffer alocado pelo chamador em que o NDIS coloca o NDIS_SYSTEM_PROCESSOR_INFO_EX estrutura e uma matriz de estruturas NDIS_PROCESSOR_INFO_EX que contêm informações sobre a topologia da CPU do computador local. O chamador fornece o comprimento do buffer no parâmetro Size .

[in, out] Size

Um ponteiro para um valor que é o tamanho, em bytes, do buffer fornecido pelo chamador. Quando a função retorna, esse valor contém a quantidade de dados que o NDIS colocou no buffer ou o tamanho necessário do buffer se o buffer for muito curto.

Retornar valor

NdisGetProcessorInformationEx pode retornar um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	A operação foi concluída com sucesso.
NDIS_STATUS_BUFFER_TOO_SHORT	O tamanho do buffer no parâmetro Size era muito pequeno. Nesse caso, o NDIS fornece o tamanho do buffer necessário no membro Size .

Comentários

Os drivers NDIS chamam a função NdisGetProcessorInformationEx para recuperar informações sobre os processadores no computador local.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.20 e posterior.
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL