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 には、が指す情報を する呼び出し元によって割り当てられたバッファーのサイズが格納されます。 戻り値は、リレーションシップ情報が設定されたバイト数を受け取ります。
戻り値
StorPortGetLogicalProcessorRelationshipルーチンは、呼び出しが成功した場合にSTOR_STATUS_SUCCESSを返します。 考えられるエラー戻り値は次のとおりです。
| リターン コード | 形容 |
|---|---|
| STOR_STATUS_BUFFER_TOO_SMALL | 指定されたバッファーは、要求された情報を保持するのに十分な大きさではありません。 |
| STOR_STATUS_INVALID_PARAMETER | 1 つ以上のパラメーターが無効です。たとえば、ProcessNumber は無効な情報を指しています。 |
| STOR_STATUS_NOT_IMPLEMENTED | この関数は、アクティブなオペレーティング システムでは実装されません。 |
備考
返される情報には、ホスト システム内の論理プロセッサで構成されるプロセッサ アフィニティ マスクが含まれます。 これらの論理プロセッサは、指定されたリレーションシップの種類を共有します。
詳細については、KeQueryLogicalProcessorRelationshipのを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | storport.h (Storport.h を含む) |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | StorPortIrql(storport) を する |