共用方式為

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。 可能的錯誤傳回值包括下列專案。

傳回碼 描述
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）