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이거나, OR 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