IWDFIoRequest::SetCompletionCallback 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. For more info, see Getting Started with UMDF.]

SetCompletionCallback 메서드는 I/O 요청이 완료되면 프레임워크에서 호출해야 하는 OnCompletion 메서드에 대한 인터페이스를 등록합니다.

구문

void SetCompletionCallback(
  [in]           IRequestCallbackRequestCompletion *pCompletionCallback,
  [in, optional] void                              *pContext
);

매개 변수

[in] pCompletionCallback

I/O 요청이 완료된 후 프레임워크가 호출하는 OnCompletion 메서드가 있는 IRequestCallbackRequestCompletion 인터페이스에 대한 포인터입니다. UMDF 버전 1.9부터 드라이버는 NULL 을 지정하여 이전에 등록된 OnCompletion 메서드를 등록 취소할 수 있습니다.

[in, optional] pContext

요청 완료와 관련된 컨텍스트 정보가 포함된 버퍼에 대한 포인터입니다. 프레임워크는 IRequestCallbackRequestCompletion::OnCompletion 메서드에 대한 호출에서 이 컨텍스트 정보를 전달합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

없음

설명

하위 수준 드라이버가 요청을 완료할 때 I/O 요청을 전달하는 드라이버에 알림이 필요한 경우 드라이버는 완료 루틴을 제공하고 SetCompletionCallback 을 호출하여 완료 루틴에 대한 IRequestCallbackRequestCompletion 인터페이스를 등록할 수 있습니다. 프레임워크는 하위 수준 드라이버가 I/O 요청을 완료한 후 완료 루틴을 호출합니다.

예제

SetCompletionCallback 메서드를 사용하는 방법에 대한 코드 예제는 IWDFIoRequest::Send를 참조하세요.

요구 사항

지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	바탕 화면
최소 UMDF 버전	1.5
헤더	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll

참조

IRequestCallbackRequestCompletion

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest

IWDFIoRequest::Send