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)