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에서 모든 작업이 발생할 필요는 없습니다. 미니포트 드라이버에 정의되고 StorPortIssueDpc를 사용하여 발급된 [HwStorDpcRoutine](nc-storport-hw_dpc_routine.md)로 연기되어야 합니다. 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 대한 자세한 내용은 함수 동작에 주석을 추가를 참조하세요.

요구 사항

추가 정보

[HwStorDpcRoutine] (nc-storport-hw_dpc_routine.md

StorPortIssueDpc