ScsiPortInitialize 함수(srb.h)

  • 아티클

플러그 앤 플레이 없는 미니포트 드라이버의 경우 ScsiPortInitialize 루틴은 PORT_CONFIGURATION_INFORMATION 구조를 설정하고 미니포트 드라이버의 HwScsiFindAdapter 루틴을 호출합니다. 또한 ScsiPortInitialize 는 미니포트 드라이버를 대신하여 시스템 개체 및 리소스를 설정합니다. 플러그 앤 플레이 미니포트 드라이버의 경우 ScsiPortInitialize는 나중에 사용할 수 있는 미니포트 드라이버의 초기화 데이터를 저장합니다.

참고 SCSI 포트 드라이버 및 SCSI 미니포트 드라이버 모델은 나중에 변경되거나 사용할 수 없습니다. 대신 Storport 드라이버 및 Storport 미니포트 드라이버 모델을 사용하는 것이 좋습니다.
 

구문

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

매개 변수

[in] Argument1

운영 체제가 DriverEntry 루틴의 첫 번째 인수에서 미니포트 드라이버에 전달한 드라이버 개체에 대한 포인터입니다.

[in] Argument2

운영 체제가 DriverEntry의 두 번째 인수에서 미니포트 드라이버에 전달한 일부 컨텍스트 정보에 대한 포인터입니다.

[in] HwInitializationData

DriverEntry에서 제공하는 초기화 및 구성 정보에 대한 포인터입니다.

[in] HwContext

미니포트 드라이버의 HwScsiFindAdapter 루틴에 전달할 컨텍스트 값의 주소를 지정합니다. 포트 드라이버에서 구성 정보를 수신하는 대신 버스에서 HBA를 검색하는 레거시 미니포트 드라이버만 이 매개 변수를 사용하여 HwScsiFindAdapter 호출 간에 상태를 저장할 수 있습니다.

반환 값

ScsiPortInitialize는 미니포트 드라이버의 DriverEntry 루틴에서 반환 값으로 사용되는 상태 값을 반환합니다.

설명

모든 미니포트 드라이버의 DriverEntry 루틴은 미니포트 드라이버가 처음 0이 된 후 ScsiPortInitialize 를 호출한 다음 HW_INITIALIZATION_DATA 설정해야 합니다.

미니포트 드라이버가 Isa 및 MicroChannel 형식 I/O 버스와 같은 다양한 유형의 I/O 버스에서 HBA를 지원할 수 있는 경우 미니포트 드라이버는 지원되는 각 인터페이스 유형에 대해 ScsiPortInitialize 를 호출해야 합니다.

ScsiPortInitialize를 두 번 이상 호출하는 미니포트 드라이버는 각 호출에서 ScsiPortInitialize에서 반환된 값을 검사 모든 호출에 대해 가장 낮은 값을 저장해야 합니다. DriverEntry 루틴은 컨트롤을 시스템에 반환할 때 가장 낮은 값을 반환해야 합니다. 미니포트 드라이버 작성기는 ScsiPortInitialize에서 반환된 값에 대해 가정할 수 없습니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 srb.h(Miniport.h, Scsi.h 포함)
라이브러리 Scsiport.lib

추가 정보

SCSI 미니포트 드라이버의 DriverEntry

SCSI(HW_INITIALIZATION_DATA)

HwScsiFindAdapter