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


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

Подпрограмма 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 структур, содержащих сведения, запрошенные вызывающим объектом. Если функция завершается сбоем, содержимое этого буфера не определено. Задайте для параметра Information значение NULL, чтобы получить необходимую длину буфера перед выделением буфера. Дополнительные сведения см. в разделе KeQueryLogicalProcessorRelationship .

[in, out] Length

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

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

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 7
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI StorPortIrql(storport)