共用方式為

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 包含 Information 所指向之呼叫端配置的緩衝區大小。 傳回時，這個值會接收以關聯性資訊填入的位元組數目。

傳回值

如果呼叫成功， StorPortGetLogicalProcessorRelationship例程會傳回STOR_STATUS_SUCCESS。 可能的錯誤傳回值包括下列專案。

傳回碼 Description
STOR_STATUS_BUFFER_TOO_SMALL 提供的緩衝區不夠大，無法保存要求的資訊。
STOR_STATUS_INVALID_PARAMETER 一或多個參數無效;例如， ProcessNumber 指向無效的資訊。
STOR_STATUS_NOT_IMPLEMENTED 此函式不會在作用中的操作系統上實作。

備註

傳回的資訊包括由主機系統中邏輯處理器所組成的處理器親和性遮罩。 這些邏輯處理器會共用指定的關聯性類型。

如需詳細資訊 ，請參閱KeQueryLogicalProcessorRelationship 。

規格需求

需求 值
最低支援的用戶端 Windows 7
目標平台 Universal
標頭 storport.h (包含 Storport.h)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 StorPortIrql (storport)