ScsiPortInitialize 함수(srb.h)
비 플러그 앤 플레이 미니포트 드라이버의 경우 ScsiPortInitialize 루틴은 PORT_CONFIGURATION_INFORMATION 구조를 설정하고 미니포트 드라이버의 HwScsiFindAdapter 루틴을 호출합니다. ScsiPortInitialize 미니포트 드라이버를 대신하여 시스템 개체 및 리소스를 설정합니다. 플러그 앤 플레이 미니포트 드라이버의 경우 ScsiPortInitialize 나중에 사용하기 위해 미니포트 드라이버의 초기화 데이터를 저장합니다.
통사론
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 |