Função StorPortGetLogicalProcessorRelationship (storport.h)

A rotina StorPortGetLogicalProcessorRelationship obtém informações sobre as relações de um ou mais processadores com os outros processadores em um sistema multiprocessador. Consulte KeQueryLogicalProcessorRelationship para obter detalhes adicionais.

Sintaxe

ULONG StorPortGetLogicalProcessorRelationship(
  [in]           PVOID                                    HwDeviceExtension,
  [in, optional] PPROCESSOR_NUMBER                        ProcessorNumber,
  [in]           LOGICAL_PROCESSOR_RELATIONSHIP           RelationshipType,
  [out]          PSYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX Information,
  [in, out]      PULONG                                   Length
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in, optional] ProcessorNumber

Um ponteiro opcional para um número de processador para o qual as relações devem ser retornadas. Para solicitar informações sobre todos os processadores lógicos no sistema, defina esse parâmetro como NULL.

[in] RelationshipType

Indica o tipo de relação a ser retornado. Consulte KeQueryLogicalProcessorRelationship para obter detalhes.

[out] Information

Um ponteiro para um buffer alocado pelo chamador que recebe uma matriz de uma ou mais estruturas SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX que contêm as informações solicitadas pelo chamador. Se a função falhar, o conteúdo desse buffer será indefinido. Defina Informações como NULL para obter o comprimento do buffer necessário antes de alocar o buffer. Consulte KeQueryLogicalProcessorRelationship para obter detalhes adicionais.

[in, out] Length

Um ponteiro para o tamanho do buffer de informações, em bytes. Na entrada, Length contém o tamanho do buffer alocado pelo chamador para o qual As informações apontam. No retorno, esse valor recebe o número de bytes preenchidos com informações de relação.

Retornar valor

A rotina StorPortGetLogicalProcessorRelationshipretornará STOR_STATUS_SUCCESS se a chamada for bem-sucedida. Possíveis valores retornados por erro incluem o seguinte.

Código de retorno	Descrição
STOR_STATUS_BUFFER_TOO_SMALL	O buffer fornecido não é grande o suficiente para conter as informações solicitadas.
STOR_STATUS_INVALID_PARAMETER	Um ou mais dos parâmetros são inválidos; por exemplo, ProcessNumber aponta para informações inválidas.
STOR_STATUS_NOT_IMPLEMENTED	Essa função não é implementada no sistema operacional ativo.

Comentários

As informações retornadas incluem máscaras de afinidade de processador compostas pelos processadores lógicos no sistema host. Esses processadores lógicos compartilham os tipos de relação especificados.

Consulte KeQueryLogicalProcessorRelationship para obter detalhes adicionais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7
Plataforma de Destino	Universal
Cabeçalho	storport.h (inclua Storport.h)
IRQL	<=DISPATCH_LEVEL
Regras de conformidade da DDI	StorPortIrql(storport)