PHW_FIND_ADAPTER 콜백 함수(srb.h)
PHW_FIND_ADAPTER 프로토타입은 제공된 구성을 사용하여 특정 HBA가 지원되는지 여부를 확인하고 해당 어댑터에 대한 구성 정보를 반환하는 루틴을 선언합니다.
구문
PHW_FIND_ADAPTER PhwFindAdapter;
ULONG PhwFindAdapter(
[in] PVOID DeviceExtension,
[in] PVOID HwContext,
[in] PVOID BusInformation,
[in] PCHAR ArgumentString,
[in, out] PPORT_CONFIGURATION_INFORMATION ConfigInfo,
[out] PBOOLEAN Again
)
{...}
매개 변수
[in] DeviceExtension
미니포트 드라이버의 HBA당 스토리지 영역에 대한 포인터입니다.
[in] HwContext
Storport 드라이버의 미니포트 드라이버 중 하나에서 사용하는 경우 예약된 멤버입니다. SCSI 미니포트 드라이버를 사용하면 이 멤버가 컨텍스트 값을 가리킵니다. SCSI 미니포트 드라이버에 대한 이 멤버의 의미에 대한 설명은 HwScsiFindAdapter를 참조하세요.
[in] BusInformation
Storport 드라이버의 미니포트 드라이버 중 하나에서 사용하는 경우 예약된 멤버입니다. SCSI 미니포트 드라이버를 사용하면 이 멤버는 OS 관련 포트 드라이버가 수집한 버스 유형별 정보를 가리킵니다. SCSI 미니포트 드라이버에 대한 이 멤버의 의미에 대한 전체 설명은 HwScsiFindAdapter를 참조하세요.
[in] ArgumentString
Storport 드라이버의 미니포트 드라이버 중 하나에서 사용하는 경우 예약된 멤버입니다. SCSI 미니포트 드라이버를 사용하면 이 멤버는 레지스트리의 기본 매개 변수 또는 인터럽트 수준과 같은 디바이스 정보가 포함된 null로 종료된 ASCII 문자열을 가리킵니다. SCSI 미니포트 드라이버에 대한 이 멤버의 의미에 대한 전체 설명은 HwScsiFindAdapter를 참조하세요.
[in, out] ConfigInfo
HBA에 대한 구성 정보를 포함하는 PORT_CONFIGURATION_INFORMATION 구조체에 대한 포인터입니다.
[out] Again
Storport 드라이버의 미니포트 드라이버 중 하나에서 사용하는 경우 예약된 멤버입니다. SCSI 미니포트 드라이버를 사용하면 이 멤버가 이 루틴을 다시 호출해야 하는지 여부를 포트 드라이버에 알리는 BOOLEAN 변수를 가리킵니다. SCSI 미니포트 드라이버에 대한 이 멤버의 의미에 대한 자세한 내용은 HwScsiFindAdapter를 참조하세요.
반환 값
이 프로토타입에서 선언한 루틴은 다음 상태 값 중 하나를 반환해야 합니다.
| 반환 코드 | 설명 |
|---|---|
| SP_RETURN_FOUND | 지원되는 HBA가 발견되었고 HBA 관련 구성 정보가 성공적으로 결정되고 PORT_CONFIGURATION_INFORMATION 구조에서 설정되었음을 나타냅니다. |
| SP_RETURN_ERROR | HBA가 발견되었지만 구성 정보를 가져오는 동안 오류가 발생했음을 나타냅니다. 가능하면 이러한 오류를 ScsiPortLogError로 기록해야 합니다. |
| SP_RETURN_BAD_CONFIG | 제공된 구성 정보가 어댑터에 유효하지 않음을 나타냅니다. |
| SP_RETURN_NOT_FOUND | 제공된 구성 정보에 대해 지원되는 HBA를 찾을 수 없음을 나타냅니다. |
설명
이 선언은 SCSI 및 StorPort 미니포트 드라이버 모두에서 사용됩니다.
이 선언과 연결된 루틴의 SCSI 미니포트 드라이버 버전에 대한 자세한 내용은 HwScsiFindAdapter를 참조하세요.
이 선언과 연결된 Storport 드라이버의 루틴 버전에 대한 자세한 내용은 HwStorFindAdapter를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | srb.h(Storport.h, Srb.h, Storport.h 포함) |