EVT_SERCX_TRANSMIT_CANCEL 콜백 함수(sercx.h)

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

구문

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

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

매개 변수

[in] Device

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

반환 값

없음

설명

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

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

예제

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

typedef VOID
  EVT_SERCX_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

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

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

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

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

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

요구 사항

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