Método IWDFFile2::GetRelatedFileObject (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método GetRelatedFileObject recupera a interface IWDFFile de um objeto de arquivo relacionado, que é um objeto de arquivo que tem uma relação específica de tecnologia com outro objeto de arquivo.

Sintaxe

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

Parâmetros

[out] ppRelatedFileObj

O endereço de um local que recebe um ponteiro para a interface IWDFFile de um objeto de arquivo UMDF. Esse objeto de arquivo está relacionado ao objeto de arquivo que expõe a interface IWDFFile2 pai da interface IWDFFile .

Retornar valor

Nenhum

Comentários

O uso de objetos de arquivo relacionados é específico da tecnologia. Por exemplo, o streaming de kernel usa objetos de arquivo relacionados para representar os filtros pai de pinos filho.

Para obter mais informações sobre objetos de arquivo relacionados, consulte o membro GetRelatedFileObject da estrutura de FILE_OBJECT do modo kernel.

Exemplos

O exemplo de código a seguir recupera a interface IWDFFile de um objeto de arquivo relacionado, da interface IWDFFile que a função de retorno de chamada IQueueCallbackCreate::OnCreateFile de um driver recebe.

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);
    ...

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1,9
Cabeçalho wudfddi.h (inclua Wudfddi.h)
DLL WUDFx.dll

Confira também

IWDFFile2