IWDFObject::RetrieveContext 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
RetrieveContext 메서드는 IWDFObject::AssignContext 메서드를 통해 이전에 등록된 컨텍스트를 검색합니다.
통사론
HRESULT RetrieveContext(
[out] void **ppvContext
);
매개 변수
[out] ppvContext
이전에 등록된 컨텍스트에 대한 포인터를 수신하는 버퍼에 대한 포인터입니다.
반환 값
RetrieveContext 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.
발언
컨텍스트가 COM(구성 요소 개체 모델) 인터페이스가 아니므로 드라이버는 컨텍스트를 이와 같이 처리해서는 안 됩니다. 예를 들어 드라이버는 컨텍스트에서 AddRef 메서드를 호출할 수 없습니다.
예제
RetrieveContext 메서드를 사용하는 방법에 대한 코드 예제는 IWDFIoQueue::GetDevice참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.5 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |