HW_INTERRUPT 콜백 함수(storport.h)

Storport 드라이버는 HBA가 인터럽트 요청을 생성한 후 HwStorInterrupt 루틴을 호출합니다.

통사론

HW_INTERRUPT HwInterrupt;

BOOLEAN HwInterrupt(
  PVOID DeviceExtension
)
{...}

매개 변수

DeviceExtension

HBA 스토리지 영역당 미니포트 드라이버에 대한 포인터입니다.

반환 값

미니포트 드라이버에서 HBA가 인터럽트를 생성하지 않은 것으로 확인되면 HwStorInterrupt 가능한 한 빨리 FALSE 반환해야 합니다. HwStorInterrupt 루틴은 50 마이크로초 이내에 반환되어야 합니다.

발언

HwStorInterrupt 이름은 자리 표시자일 뿐입니다. 이 루틴의 실제 프로토타입은 다음과 같이 storport.h 정의됩니다.

typedef
BOOLEAN
HW_INTERRUPT (
  IN PVOID  DeviceExtension
  );

HwStorInterrupt 루틴은 50 마이크로초 이내에 반환되어야 하며, 가능한 한 짧은 시간이 이상적입니다. 따라서 모든 작업은 높은 IRQL에서 발생할 필요가 없습니다 [HwStorDpcRoutine](nc-storport-hw_dpc_routine.md는 미니 포트 드라이버에 정의되고 StorPortIssueDpc사용하여 발급됩니다. DPC의 대기 시간은 매우 낮으며 높은 IRQL에서 반환된 직후에 호출됩니다.

포트 드라이버는 DIRQL에서 HwStorInterrupt 루틴을 호출합니다.

예제

HwStorInterrupt 콜백 함수를 정의하려면 먼저 정의하는 콜백 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 콜백 함수 형식 집합을 제공합니다. 콜백 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 myHwInterrupt 이름이HwStorInterrupt 콜백 루틴을 정의하려면 다음 코드 예제와 같이 HW_INTERRUPT 형식을 사용합니다.

HW_INTERRUPT MyHwInterrupt;

그런 다음 다음과 같이 콜백 루틴을 구현합니다.

_Use_decl_annotations_
BOOLEAN
MyHwInterrupt (
  _In_ PVOID  DeviceExtension
  );
  {
      ...
  }

HW_INTERRUPT 함수 형식은 Storport.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 HW_INTERRUPT 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 storport 드라이버 함수 역할 형식을 사용하여 함수 선언참조하세요. Use_decl_annotations대한 자세한 내용은 함수 동작 주석참조하세요.

요구 사항

요구	값
대상 플랫폼	보편적
헤더	storport.h(Storport.h 포함)
IRQL	DIRQL

참고 항목

[HwStorDpcRoutine](nc-storport-hw_dpc_routine.md

storPortIssueDpc