StorPortInitialize 루틴은 포트 드라이버 매개 변수 및 확장 데이터를 초기화합니다. StorPortInitialize미니포트 드라이버DriverEntry 루틴에서 제공된 어댑터 정보도 저장합니다.
통사론
STORPORT_API ULONG StorPortInitialize(
[in] PVOID Argument1,
[in] PVOID Argument2,
[in] _HW_INITIALIZATION_DATA *HwInitializationData,
[in, optional] PVOID HwContext
);
매개 변수
[in] Argument1
운영 체제가 미니포트의 DriverEntry 루틴을 호출한 첫 번째 포인터입니다.
[in] Argument2
운영 체제가 미니포트의 DriverEntry 루틴을 호출한 두 번째 포인터입니다.
[in] HwInitializationData
DriverEntry 루틴에서 미니포트 드라이버가 설정한 초기화 및 구성 정보에 대한 포인터입니다.
[in, optional] HwContext
미니포트 드라이버의 HwStorFindAdapter 루틴에 전달할 컨텍스트 값의 주소입니다. 포트 드라이버에서 구성 정보를 수신하는 대신 HBA용 버스를 검색하는 레거시 미니포트 드라이버만 이 매개 변수를 사용하여 HwStorFindAdapter호출 간에 상태를 저장할 수 있습니다.
반환 값
StorPortInitialize수행된 초기화 작업의 결과입니다. 미니포트 드라이버는 이 값을 DriverEntry 루틴의 반환 값으로 반환합니다.
StorPortInitialize 다음 상태 코드 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| 파라미터 값이 잘못되었습니다 | Argument1 NULL이거나 Argument2 NULL이거나 HwInitializationData NULL인. |
| STATUS_SUCCESS | 드라이버 확장 데이터 및 어댑터 정보가 성공적으로 초기화되었습니다. |
| STATUS_NO_MEMORY | 초기화 매개 변수를 저장하는 데 사용할 수 있는 메모리가 없습니다. |
| STATUS_REVISION_MISMATCH | HwInitializationData 가리키는 구조의 버전이 현재 운영 체제에 유효하지 않습니다. |
| STATUS_INSUFFICENT_RESOURCES | 드라이버 개체 확장 데이터에 대한 할당이 실패했습니다. |
발언
이 루틴은 미니포트 드라이버의 DriverEntry 루틴에서 호출해야 합니다.
Storport 미니포트 드라이버는 PnP를 지원해야 하므로 Storport 드라이버는 storPortInitialize 전달된 HwContext 매개 변수를 사용하지 않습니다.
미니포트 드라이버가 처음 0이 되면 모든 미니포트 드라이버의 DriverEntry 루틴에서 StorPortInitialize 호출한 다음 HW_INITIALIZATION_DATA멤버를 설정해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | storport.h(Storport.h 포함) |
| 도서관 | Storport.lib |