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 |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기