次の方法で共有

StorPortGetLogicalProcessorRelationship 関数 (storport.h)

  • [アーティクル]

StorPortGetLogicalProcessorRelationship ルーチンは、マルチプロセッサ システム内の他のプロセッサとの 1 つ以上のプロセッサの関係に関する情報を取得します。 詳細については、「 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

呼び出し元によって要求された情報を含む 1 つ以上の 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 1 つ以上のパラメーターが無効です。たとえば、 ProcessNumber は無効な情報を指します。
STOR_STATUS_NOT_IMPLEMENTED この関数は、アクティブなオペレーティング システムには実装されません。

注釈

返される情報には、ホスト システム内の論理プロセッサで構成されるプロセッサ アフィニティ マスクが含まれます。 これらの論理プロセッサは、指定されたリレーションシップの種類を共有します。

詳細については、「 KeQueryLogicalProcessorRelationship 」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 7
対象プラットフォーム ユニバーサル
Header storport.h (Storport.h を含む)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 StorPortIrql(storport)