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 mais detalhes.
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 por 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 mais detalhes.
[in, out] Length
Um ponteiro para o tamanho do buffer de informações, em bytes. Na entrada, comprimento contém o tamanho do buffer alocado pelo chamador para o qual as informações aponta. No retorno, esse valor recebe o número de bytes preenchidos com informações de relação.
Valor de retorno
A rotina StorPortGetLogicalProcessorRelationshipretornará STOR_STATUS_SUCCESS se a chamada for bem-sucedida. Os valores de retorno de erro possíveis 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. |
Observações
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 mais detalhes.