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

  • Artículo

[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

Consulte también

IWDFFile2