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 포함) |