通过

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 结构的数组。 如果函数失败，则未定义此缓冲区的内容。 将 信息 设置为 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）