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)