WUDF_INTERRUPT_DISABLE 콜백 함수(wudfinterrupt.h)

  • 아티클

경고

UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.

드라이버의 OnInterruptDisable 이벤트 콜백 함수는 지정된 하드웨어 인터럽트를 사용하지 않도록 설정합니다.

구문

WUDF_INTERRUPT_DISABLE WudfInterruptDisable;

HRESULT WudfInterruptDisable(
  [in] IWDFInterrupt *Interrupt,
  [in] IWDFDevice *AssociatedDevice
)
{...}

매개 변수

[in] Interrupt

IWDFInterrupt 인터페이스에 대한 포인터입니다.

[in] AssociatedDevice

드라이버가 CreateInterrupt를 호출하는 데 사용한 IWDFDevice 인터페이스에 대한 포인터입니다.

반환 값

작업이 성공하면 OnInterruptDisable이 S_OK 반환해야 합니다. 그렇지 않으면 콜백은 Winerror.h에 정의된 오류 코드 중 하나를 반환해야 합니다.

설명

OnInterruptDisable 콜백 함수를 등록하려면 드라이버가 IWDFDevice::CreateInterrupt를 호출하기 전에 콜백 함수의 주소를 WUDF_INTERRUPT_CONFIG 구조에 배치해야 합니다.

프레임워크는 디바이스가 작동(D0) 상태를 떠날 때마다 드라이버의 OnInterruptDisable 콜백 함수를 호출합니다. 또한 드라이버는 IWDFInterrupt::D isable을 호출하여 프레임워크가 OnInterruptDisable 콜백 함수를 호출하도록 할 수 있습니다.

OnInterruptDisable 콜백 함수를 호출하기 전에 프레임워크는 드라이버의 OnD0ExitPreInterruptsDisabled 이벤트 콜백 함수를 호출하고 사용자 모드 인터럽트 잠금을 획득합니다.

UMDF 드라이버에서 인터럽트 처리에 대한 자세한 내용은 하드웨어 액세스 및 인터럽트 처리를 참조하세요.

예제

함수 형식은 다음과 같이 Wudfinterrupt.h에서 선언됩니다.

typedef
__drv_functionClass(WUDF_INTERRUPT_DISABLE)
HRESULT
WUDF_INTERRUPT_DISABLE(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFDevice* AssociatedDevice
    );

typedef WUDF_INTERRUPT_DISABLE *PFN_WUDF_INTERRUPT_DISABLE;

MyInterruptDisable이라는 OnInterruptDisable 콜백 함수를 정의하려면 먼저 다음과 같이 SDV 및 기타 확인 도구에 필요한 함수 선언을 제공해야 합니다.

WUDF_INTERRUPT_DISABLE  MyInterruptDisable;

그런 다음 다음과 같이 콜백 함수를 구현합니다.

HRESULT
  MyInterruptDisable (
    IN IWDFInterrupt* pInterrupt,
    IN IWDFDevice*  pAssociatedDevice
    )
  {…}

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.11
머리글 wudfinterrupt.h

추가 정보