WdfRequestSetCompletionRoutine 함수(wdfrequest.h)

[KMDF 및 UMDF에 적용]

WdfRequestSetCompletionRoutine 메서드는 지정된 프레임워크 요청 개체에 대한 완료 루틴을 등록하거나 등록 취소합니다.

구문

void WdfRequestSetCompletionRoutine(
  [in]           WDFREQUEST                         Request,
  [in, optional] PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine,
  [in, optional] __drv_aliasesMem WDFCONTEXT        CompletionContext
);

매개 변수

[in] Request

프레임워크 요청 개체에 대한 핸들입니다.

[in, optional] CompletionRoutine

드라이버가 완료 루틴을 등록하는 경우 CompletionRoutine 콜백 함수에 대한 포인터이거나 드라이버의 NULL 이 이전에 등록된 완료 루틴의 등록을 취소하는 경우 입니다.

[in, optional] CompletionContext

프레임워크가 CompletionRoutine 콜백 함수에 전달하는 드라이버 정의 컨텍스트 정보에 대한 형식화되지 않은 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

없음

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

드라이버가 I/O 요청을 전달하지만 하위 수준 드라이버가 요청을 완료할 때 드라이버에 알림을 표시하려는 경우 드라이버는 CompletionRoutine 콜백 함수를 제공하고 WdfRequestSetCompletionRoutine 을 호출하여 함수를 등록할 수 있습니다. 프레임워크는 하위 수준 드라이버가 I/O 요청을 완료한 후 콜백 함수를 호출합니다.

WdfRequestSetCompletionRoutine에 대한 자세한 내용은 I/O 요청 완료를 참조하세요.

예제

WdfRequestSetCompletionRoutine을 사용하는 코드 예제는 WdfRequestSend를 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfrequest.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<=DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), ReqCompletionRoutine(kmdf)

추가 정보

CompletionRoutine