다음을 통해 공유

EVT_SERCX_RECEIVE_CANCEL 콜백 함수(sercx.h)

  • 아티클

EvtSerCxReceiveCancel 이벤트 콜백 함수는 보류 중인 수신 요청이 취소되었음을 직렬 컨트롤러 드라이버에 알릴 수 있습니다.

구문

EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;

void EvtSercxReceiveCancel(
  [in] WDFDEVICE Device
)
{...}

매개 변수

[in] Device

직렬 컨트롤러를 나타내는 프레임워크 디바이스 개체에 대한 WDFDEVICE 핸들입니다.

반환 값

없음

설명

SerCx(직렬 프레임워크 확장)는 이 함수를 호출하여 현재 수신 요청이 취소되었음을 직렬 컨트롤러 드라이버에 알릴 수 있습니다. 드라이버에 미해결 수신 작업이 진행 중인 경우 드라이버는 이 작업을 취소하고 SerCxProgressReceive 메서드를 호출하여 취소를 보고해야 합니다. SerCxProgressReceive 호출에서 BytesReceived를 작업이 취소되기 전에 받은 바이트 수로 설정하고 ReceiveStatus를 SerCxStatusCancelled로 설정합니다.

EvtSerCxReceiveCancel 콜백 함수를 등록하려면 드라이버가 SerCxInitialize 메서드를 호출해야 합니다.

예제

이 콜백의 함수 형식은 다음과 같이 Sercx.h에서 선언됩니다.

typedef VOID
  EVT_SERCX_RECEIVE_CANCEL(
    __in WDFDEVICE Device
    );

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

EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

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

VOID
  MyEvtSerCxReceiveCancel(
    __in WDFDEVICE Device
    )
{ ... }

함수 선언에 대한 SDV 요구 사항에 대한 자세한 내용은 KMDF 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 사용하여 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 sercx.h
IRQL IRQL <= DISPATCH_LEVEL 호출

추가 정보

SerCxInitialize

SerCxProgressReceive