다음을 통해 공유

StorPortInitializePerfOpts 함수(storport.h)

  • 아티클

StorPortInitializePerfOpts 함수는 미니포트 드라이버와 Storport 드라이버가 모두 PERF_CONFIGURATION_DATA 구조를 사용하여 지원하는 성능 최적화를 초기화합니다.

구문

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

매개 변수

[in] HwDeviceExtension

HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다. 이 매개 변수는 NULL이 아니어야 합니다.

[in] Query

TRUE로 설정하면 Storport는 Storport에서 지원하는 최적화에 해당하는 PerfConfigData에서 플래그를 설정합니다. FALSE로 설정하면 Storport는 PerfConfigData의 플래그에 지정된 최적화를 초기화합니다.

[in, out] PerfConfigData

미니포트 드라이버에서 제공하는 PERF_CONFIGURATION_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

StorPortInitializePerfOpts는 다음 상태 값 중 하나를 반환합니다.

반환 코드 설명
STOR_STATUS_NOT_IMPLEMENTED
 이 함수는 활성 운영 체제에서 구현되지 않습니다.
STOR_STATUS_SUCCESS
 성능 최적화 설정이 적용되었음을 나타냅니다.

또는 쿼리가 TRUE로 설정된 경우 PerfConfigData가 가리키는 구조체의 Flags 멤버에 지원되는 플래그가 포함됩니다.
STOR_STATUS_UNSUCCESSFUL
 미니포트 드라이버는 Storport가 인식하지 못하는 PerfConfigData 에서 플래그를 설정하거나 미니포트 드라이버가 제공하는 HwStorInitialize 루틴 외부에서 이 루틴을 호출했습니다.
STOR_STATUS_INSUFFICIENT_RESOURCES
 요청된 최적화를 지원하기 위해 내부 구조를 할당할 수 없습니다.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 매개 변수 또는 PerfConfigData 매개 변수가 NULL이었습니다.

설명

미니포트 드라이버는 미니포트 제공 HwStorInitialize 루틴 또는 HwStorPassiveInitializeRoutine 루틴 중에만 StorPortInitializePerfOpts를 호출할 수 있습니다.

사용 가능한 성능 최적화는 PERF_CONFIGURATION_DATA 버전에 따라 달라집니다. 버전 멤버를 STOR_PERF_VERSION 설정하면 지원되는 모든 최적화를 선택할 수 있습니다.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
헤더 storport.h(Storport.h 포함)
DDI 규정 준수 규칙 StorPortPerfOpts(storport)

추가 정보

PERF_CONFIGURATION_DATA