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

아티클
08/08/2023

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 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