Функция StorPortGetLogicalProcessorRelationship (storport.h)

Статья
02/07/2025

StorPortGetLogicalProcessorRelationship получает сведения о связи одного или нескольких процессоров с другими процессорами в многопроцессорной системе. Дополнительные сведения см. в KeQueryLogicalProcessorRelationship.

Синтаксис

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
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in, optional] ProcessorNumber

Необязательный указатель на номер процессора , для которого возвращаются связи. Чтобы запросить сведения обо всех логических процессорах в системе, задайте для этого параметра значение NULL.

[in] RelationshipType

Указывает тип возвращаемой связи. Дополнительные сведения см. в KeQueryLogicalProcessorRelationship.

[out] Information

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

[in, out] Length

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

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

Подпрограмма StorPortGetLogicalProcessorRelationshipвозвращает STOR_STATUS_SUCCESS, если вызов выполнен успешно. Возможные значения возвращаемых ошибок включают следующие значения.

Возвращаемый код	Описание
STOR_STATUS_BUFFER_TOO_SMALL	Предоставленный буфер недостаточно велик для хранения запрошенных сведений.
STOR_STATUS_INVALID_PARAMETER	Один или несколько параметров недопустимы; Например, ProcessNumber указывает на недопустимые сведения.
STOR_STATUS_NOT_IMPLEMENTED	Эта функция не реализована в активной операционной системе.

Замечания

Возвращаемые сведения включают маски сходства процессора, состоящие из логических процессоров в хост-системе. Эти логические процессоры используют указанные типы связей.

Дополнительные сведения см. в KeQueryLogicalProcessorRelationship.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7
целевая платформа	Всеобщий
заголовка	storport.h (include Storport.h)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	storPortIrql(storport)

Поделиться через