StorPortLogError 함수(storport.h)
StorPortLogError 루틴은 포트 드라이버에 오류가 발생했음을 알릴 수 있습니다.
구문
STORPORT_API VOID StorPortLogError(
[in] PVOID HwDeviceExtension,
[in, optional] PSCSI_REQUEST_BLOCK Srb,
[in] UCHAR PathId,
[in] UCHAR TargetId,
[in] UCHAR Lun,
[in] ULONG ErrorCode,
[in] ULONG UniqueId
);
매개 변수
[in] HwDeviceExtension
하드웨어 디바이스 확장에 대한 포인터입니다. 포트 드라이버가 미니포트 드라이버를 대신하여 할당하고 초기화하는 HBA 스토리지 영역당 입니다. 미니포트 드라이버는 일반적으로 HBA 상태 및 HBA에 대한 매핑된 액세스 범위와 같은 HBA 관련 정보를 이 확장에 저장합니다. 이 영역은 미니포트 드라이버가 StorPortInitialize를 호출한 직후 미니포트에서 사용할 수 있습니다. 포트 드라이버는 디바이스를 제거할 때 이 메모리를 해제합니다.
[in, optional] Srb
오류와 연결된 SCSI 요청 블록에 대한 포인터입니다. 그렇지 않으면 이 매개 변수는 NULL입니다.
[in] PathId
SCSI 버스를 식별합니다.
[in] TargetId
버스의 대상 컨트롤러 또는 디바이스를 식별합니다.
[in] Lun
대상 디바이스의 논리적 단위 번호를 식별합니다.
[in] ErrorCode
다음 값 중 하나를 오류 유형으로 나타내는 오류 코드를 지정합니다.
| 값 | 의미 |
|---|---|
| SP_BAD_FW_ERROR | 드라이버가 잘못된 펌웨어 또는 이전 펌웨어를 감지했음을 나타냅니다. 디바이스는 사용되지 않습니다. |
| SP_BAD_FW_WARNING | 드라이버가 이전 펌웨어 또는 잘못된 펌웨어가 있는 카드 검색했음을 나타내며, 이로 인해 성능이나 기능이 저하될 수 있습니다. |
| SP_BUS_PARITY_ERROR | SCSI 버스 패리티 오류가 감지되었음을 나타냅니다. |
| SP_BUS_TIME_OUT | 시간 초과된 논리 단위에 대한 SCSI 버스 연결을 나타냅니다. |
| SP_INTERNAL_ADAPTER_ERROR | 내부 HBA 오류가 감지되었음을 나타냅니다. |
| SP_INVALID_RESELECTION | 예기치 않게 또는 잘못된 큐 태그가 있는 논리 단위를 다시 선택했음을 나타냅니다. |
| SP_IRQ_NOT_RESPONDING | HBA가 예상할 때 중단되지 않음을 나타냅니다. |
| SP_PROTOCOL_ERROR | 미니포트 드라이버가 SCSI 버스 프로토콜 오류를 감지했음을 나타냅니다. |
| SP_REQUEST_TIMEOUT | 컨트롤러에 대한 작업 시간이 초과되었음을 나타냅니다. |
| SP_UNEXPECTED_DISCONNECT | 대상이 예기치 않게 연결이 끊어지게 되었음을 나타냅니다. |
[in] UniqueId
오류에 대한 고유 식별자를 지정합니다. 이 값은 동일한 ErrorCode 값을 가진 다른 오류와 현재 오류를 구분합니다. 일부 미니포트 드라이버의 경우 오류가 검색된 코드 줄을 식별합니다. 다른 사용자의 경우 HBA에서 반환하는 추가 정보입니다.
반환 값
없음
설명
포트 드라이버는 시스템 이벤트 로그에 오류를 기록합니다.
Windows 8 Srb 매개 변수는 SCSI_REQUEST_BLOCK 또는 STORAGE_REQUEST_BLOCK 가리킬 수 있습니다. Srb의 함수 필드에 있는 함수 식별자가 SRB_FUNCTION_STORAGE_REQUEST_BLOCK 경우 SRB는 STORAGE_REQUEST_BLOCK 요청 구조입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | storport.h(Storport.h 포함) |
| 라이브러리 | Storport.lib |
| DDI 규정 준수 규칙 | StorPortDeprecated(storport) |