IWDFIoRequest::SetCompletionCallback 메서드(wudfddi.h)
[경고: 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 |
추가 정보
IRequestCallbackRequestCompletion