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

추가 정보

IWDFIoQueue::GetDevice

IWDFObject

IWDFObject::AssignContext