StorPortInitialize 함수(storport.h)

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 다음 상태 코드 중 하나를 반환합니다.

반환 코드	묘사
STATUS_INVALID_PARAMETER	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

참고 항목

HW_INITIALIZATION_DATA

HwStorFindAdapter