Função StorPortGetNodeAffinity2 (storport.h)

Artigo
02/07/2025

Um miniporto pode chamar StorPortGetNodeAffinity2 para obter a afinidade atual de processador de vários grupos do nó NUMA especificado.

Sintaxe

ULONG StorPortGetNodeAffinity2(
  PVOID           HwDeviceExtension,
  ULONG           NodeNumber,
  PGROUP_AFFINITY GroupAffinities,
  USHORT          GroupAffinitiesCount,
  PUSHORT         GroupAffinitiesCountRequired
);

Parâmetros

HwDeviceExtension

[in] Ponteiro para a extensão do dispositivo do miniporto.

NodeNumber

[in] O número do nó a ser consultado.

GroupAffinities

[out] Ponteiro para uma matriz de estruturas GROUP_AFFINITY que, após o sucesso, recebem um número de grupo e a máscara de afinidade do grupo identificado.

GroupAffinitiesCount

[in] O número de elementos na matriz que GroupAffinities aponta. Se a matriz for muito pequena para manter a afinidade do nó, STATUS_BUFFER_TOO_SMALL será retornado e o número de elementos necessários será retornado em GroupAffinitiesRequired.

GroupAffinitiesCountRequired

[out] Ponteiro para um valor que recebe o número de afinidades de grupo necessárias para representar a afinidade do nó.

Valor de retorno

StorPortGetNodeAffinity2 retornará STOR_STATUS_SUCCESS se a afinidade do nó tiver sido consultada com êxito. Os valores de retorno de erro possíveis incluem o seguinte.

Código de retorno	Descrição
STOR_STATUS_INVALID_PARAMETER	Há um parâmetro inválido, como um valor NodeNumber inválido.
STOR_STATUS_BUFFER_TOO_SMALL	A matriz fornecida é muito pequena.
STOR_STATUS_UNSUCCESSFUL	Ocorreu um erro por motivos internos.

Observações

Consulte a seção Comentários de KeQueryNodeActiveAffinity2 para obter detalhes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 11, versão 22H2
cabeçalho	storport.h

Consulte também

GROUP_AFFINITY

Partilhar via