IWDFFile2::GetRelatedFileObject 메서드(wudfddi.h)

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

GetRelatedFileObject 메서드는 다른 파일 개체와 기술 관련 관계가 있는 파일 개체인 관련 파일 개체의 IWDFFile 인터페이스를 검색합니다.

구문

void GetRelatedFileObject(
  [out] IWDFFile **ppRelatedFileObj
);

매개 변수

[out] ppRelatedFileObj

UMDF 파일 개체의 IWDFFile 인터페이스에 대한 포인터를 받는 위치의 주소입니다. 이 파일 개체는 IWDFFile2 인터페이스의 부모 IWDFFile 인터페이스를 노출하는 파일 개체와 관련이 있습니다.

반환 값

없음

설명

관련 파일 개체의 사용은 기술별로 다릅니다. 예를 들어 커널 스트리밍 은 관련 파일 개체를 사용하여 자식 핀의 부모 필터를 나타냅니다.

관련 파일 개체에 대한 자세한 내용은 커널 모드 FILE_OBJECT 구조체의 GetRelatedFileObject 멤버를 참조하세요.

예제

다음 코드 예제에서는 드라이버의 IQueueCallbackCreate::OnCreateFile 콜백 함수가 수신하는 IWDFFile 인터페이스에서 관련 파일 개체의 IWDFFile 인터페이스를 검색합니다.

VOID
STDMETHODCALLTYPE
CMyQueue::OnCreateFile(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in IWDFFile*  pWdfFileObject
    )
 ...
    IWDFFile*  pWdfRelatedFileObject = NULL;
    IWDFFile2*  pWdfFileObject2 = NULL;
    HRESULT  hr = S_OK;

    //
    // Obtain IWDFFile2 interface from IWDFFile.
    //
    hr = pWdfFileObject->QueryInterface(IID_PPV_ARGS(&pWdfFileObject2));
    if (!SUCCEEDED(hr))
    {
        goto Done;
    }
    pWdfFileObject2->GetRelatedFileObject(&pWdfRelatedFileObject);
    ...

요구 사항

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

추가 정보

IWDFFile2