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 |