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)