Storport 드라이버 미니포트 루틴

  • 아티클

Storport 드라이버와 함께 작동하는 미니포트 드라이버는 이 섹션에 나열된 일상적인 설명의 구현을 포함해야 하며 미니포트 드라이버의 초기화 단계에서 HW_INITIALIZATION_DATA 구조를 통해 노출해야 합니다.

Storport 미니포트 드라이버 루틴은 SCSI 포트와 거의 동일합니다. 그러나 SCSI 포트 드라이버의 디자인과 Storport 드라이버의 디자인 간에는 중요한 차이점이 있으며 미니포트 루틴은 이러한 차이를 수용해야 합니다.

예를 들면 다음과 같습니다.

  • Storport 미니포트 드라이버는 HwStorStartIo 루틴이 완료된 후 다른 I/O 요청을 받을 수 있도록 항상 준비해야 합니다.
  • SCSI 미니포트 드라이버에는 이 요구 사항이 없습니다. StorPortNotification을 호출하여 다른 요청을 처리할 수 있을 때 포트 드라이버에 명시적으로 신호를 보낼 때까지 새 I/O 요청을 수신하지 않습니다.

Storport 미니포트 드라이버가 제출된 요청을 즉시 처리할 수 없는 경우 오버로드를 처리할 수 있는 큐 관리 함수 집합이 있습니다. 이러한 큐 관리 함수는 SCSI 미니포트 드라이버에서 사용할 수 없습니다. SCSI 미니포트 드라이버와 마찬가지로 Storport 미니포트 드라이버는 SRB_STATUS_BUSY 사용하여 요청을 완료합니다. 그러나 SCSI 포트 버전과 달리 StorPortDeviceBusy 루틴을 사용하여 디바이스 큐를 사용 중으로 표시할 수도 있습니다. 유사한 함수를 사용하면 Storport 미니포트 드라이버가 어댑터 전체에서 처리를 일시 중지하고 다시 시작할 수 있습니다.

Storport 드라이버에서 제공하는 지원 루틴에 대한 자세한 내용은 Storport 드라이버 지원 루틴을 참조 하세요.

Storport 드라이버에 대한 자세한 내용은 스토리지 포트 드라이버를 참조 하세요.

Storport 미니포트 드라이버 루틴 목록

루틴에서 반환된 값 설명
HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE MSI(메시지 신호 인터럽트)를 처리합니다.
HW_ADAPTER_CONTROL 전원 관리를 위해 HBA를 중지하거나 다시 시작하는 등 어댑터의 상태 또는 동작을 제어하는 동기 작업을 수행합니다.
HW_BUILDIO SRB를 HwStorStartIo에 전달하기 전에 공유 시스템 데이터 구조에 대한 동기화되지 않은 액세스 권한으로 처리합니다.
HW_DPC_ROUTINE DPC(지연 프로시저 호출) 메커니즘을 사용하여 DISPATCH IRQL에서 실행을 위해 지연되는 루틴입니다.
HW_FIND_ADAPTER 제공된 구성을 사용하여 특정 HBA가 지원되는지 여부를 확인하고, 지원되는 경우 해당 어댑터에 대한 구성 정보를 반환합니다.
HW_INITIALIZE 시스템 재부팅 또는 전원 오류가 발생한 후 미니포트 드라이버를 초기화합니다.
HW_INTERRUPT Storport 드라이버는 HBA가 인터럽트 요청을 생성한 후 HwStorInterrupt 루틴을 호출합니다.
HW_PASSIVE_INITIALIZE_ROUTINE 현재 IRQL이 PASSIVE_LEVEL 때 HwStorInitialize 루틴 이후에 호출됩니다.
HW_RESET_BUS 오류 조건을 지우기 위해 포트 드라이버에서 호출됩니다.
HW_STARTIO Storport 드라이버는 들어오는 각 I/O 요청에 대해 HwStorStartIo 루틴을 한 번 호출합니다.
HW_TIMER 미니포트 드라이버가 RequestTimerCall NotificationType 값을 사용하여 StorPortNotification을 호출할 때 지정된 간격 이후에 호출됩니다.
HW_TRACING_ENABLED Storport가 미니포트에 이벤트 추적이 사용하도록 설정되어 있음을 알릴 수 있도록 합니다.
HW_UNIT_CONTROL 스토리지 단위 디바이스의 상태를 제어하기 위해 동기 작업을 수행하기 위해 호출됩니다. 미니포트 드라이버는 단위를 시작하거나 장치 디바이스에 대한 전원 상태 전환을 처리하라는 알림을 받습니다.
HW_WORKITEM Storport 작업 항목 요청을 처리하기 위한 미니포트 제공 콜백 함수입니다.