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