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

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

GetFileObject 메서드는 I/O 요청과 연결된 IWDFFile 인터페이스에 대한 포인터를 검색합니다.

구문

void GetFileObject(
  [out] IWDFFile **ppFileObject
);

매개 변수

[out] ppFileObject

파일 개체에 대한 IWDFFile 인터페이스에 대한 포인터를 수신하는 버퍼에 대한 포인터입니다. NULL 반환은 유효합니다.

반환 값

없음

설명

드라이버가 GetFileObject를 호출하면 프레임워크는 인터페이스에서 참조 횟수를 증가합니다. 드라이버는 인터페이스 포인터로 완료되면 참조를 해제해야 합니다. 이렇게 하려면 개체가 컨텍스트를 벗어날 때 참조 수를 자동으로 감소시키는 스마트 포인터를 사용하거나, 완료될 때 인터페이스에서 Release 를 호출합니다.

예제

다음 코드 예제는 WDK의 WpdMultiTransportDriver 샘플에서 가져옵니다. 이 예제에서는 IWDFFile 인터페이스에 대한 스마트 포인터를 선언하고 GetFileObject를 호출한 다음 파일 개체에서 RetrieveContext 를 호출합니다.

  CComPtr<IWDFFile>   pFileObject;

  ...

  // Get the Context map for this client

  pRequest->GetFileObject(&pFileObject);

  if (pFileObject != NULL)
  {
      hr = pFileObject->RetrieveContext((void**)&pClientContextMap);
      CHECK_HR(hr, "Failed to get Contextmap from WDF File Object");
  }

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.5
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보

IWDFFile

IWDFIoRequest