StorPortGetStartIoPerfParams 함수(storport.h)

  • 아티클

StorPortGetStartIoPerfParams 루틴은 지정된 I/O 요청에 대한 성능 매개 변수를 STARTIO_PERFORMANCE_PARAMETERS 구조에 배치합니다.

구문

ULONG StorPortGetStartIoPerfParams(
  [in]      PVOID                           HwDeviceExtension,
  [in]      PSCSI_REQUEST_BLOCK             Srb,
  [in, out] PSTARTIO_PERFORMANCE_PARAMETERS StartIoPerfParams
);

매개 변수

[in] HwDeviceExtension

HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다.

[in] Srb

미니포트 드라이버에서 제공한 HwStorStartIo 루틴에 전달된 SRB 포인터입니다. 이 매개 변수는 NULL이 아니어야 합니다.

[in, out] StartIoPerfParams

미니포트 드라이버가 제공하는 STARTIO_PERFORMANCE_PARAMETERS 구조체에 대한 포인터입니다. Storport가 다른 멤버를 설정하므로 미니포트 드라이버는 할당된 구조체의 크기만 설정해야 합니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

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

반환 코드 설명
STOR_STATUS_NOT_IMPLEMENTED
 이 함수는 활성 운영 체제에서 구현되지 않습니다.
STOR_STATUS_SUCCESS
 성능 매개 변수가 StartIoPerfParams에 저장되었음을 나타냅니다.
STOR_STATUS_INVALID_PARAMETER
 Srb 매개 변수 또는 StartIoPerfParams 매개 변수는 NULL입니다.

또는

HwDeviceExtension 매개 변수가 NULL이거나 유효하지 않습니다.

또는

Srb 매개 변수가 Storport에서 보낸 SRB를 가리키지 않습니다.

또는

StartIoPerfParams가 가리키는 구조체는 Size 멤버의 값이 구조체가 너무 작아서 반환된 데이터를 포함할 수 없음을 나타내기 때문에 유효하지 않습니다.

설명

Windows 8 Srb 매개 변수는 SCSI_REQUEST_BLOCK 또는 STORAGE_REQUEST_BLOCK 가리킬 수 있습니다. Srb의 함수 필드에 있는 함수 식별자가 SRB_FUNCTION_STORAGE_REQUEST_BLOCK 경우 SRB는 STORAGE_REQUEST_BLOCK 요청 구조입니다.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
헤더 storport.h(Storport.h 포함)

추가 정보

SCSI_REQUEST_BLOCK

STARTIO_PERFORMANCE_PARAMETERS

STORAGE_REQUEST_BLOCK