Método IWDFFile2::GetRelatedFileObject (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.
El método GetRelatedFileObject recupera la interfaz IWDFFile de un objeto de archivo relacionado, que es un objeto de archivo que tiene una relación específica de la tecnología con otro objeto de archivo.
Sintaxis
void GetRelatedFileObject(
[out] IWDFFile **ppRelatedFileObj
);
Parámetros
[out] ppRelatedFileObj
Dirección de una ubicación que recibe un puntero a la interfaz IWDFFile de un objeto de archivo UMDF. Este objeto de archivo está relacionado con el objeto de archivo que expone la interfaz IWDFFile2 principal de la interfaz IWDFFile .
Valor devuelto
None
Observaciones
El uso de objetos de archivo relacionados es específico de la tecnología. Por ejemplo, el streaming de kernel usa objetos de archivo relacionados para representar los filtros primarios de los patillas secundarias.
Para obtener más información sobre los objetos de archivo relacionados, vea el miembro GetRelatedFileObject de la estructura FILE_OBJECT modo kernel.
Ejemplos
En el ejemplo de código siguiente se recupera la interfaz IWDFFile de un objeto de archivo relacionado, de la interfaz IWDFFile que recibe la función de devolución de llamada IQueueCallbackCreate::OnCreateFile de un controlador.
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 | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1,9 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |