Método IWDFIoRequest::GetFileObject (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante 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 a UMDF.]
El método getFileObject de recupera un puntero a la interfaz IWDFFile asociada a una solicitud de E/S.
Sintaxis
void GetFileObject(
[out] IWDFFile **ppFileObject
);
Parámetros
[out] ppFileObject
Puntero a un búfer que recibe un puntero a la interfaz IWDFFile del objeto de archivo. Tenga en cuenta que devolver NULL es válido.
Valor devuelto
Ninguno
Observaciones
Cuando el controlador llama a GetFileObject, el marco incrementa el recuento de referencias en la interfaz. El controlador es responsable de liberar la referencia cuando termine con el puntero de interfaz. Para ello, use un puntero inteligente que reduzca automáticamente el recuento de referencias cuando el objeto salga del contexto o llame a Release en la interfaz cuando termine con él.
Ejemplos
El ejemplo de código siguiente se toma del ejemplo WpdMultiTransportDriver en WDK. En el ejemplo se declara un puntero inteligente a una interfaz IWDFFile, se llama a GetFileObjecty, a continuación, llama a RetrieveContext en el objeto de archivo.
CComPtr<IWDFFile> pFileObject;
...
// Get the Context map for this client
pRequest->GetFileObject(&pFileObject);
if (pFileObject != NULL)
{
hr = pFileObject->RetrieveContext((void**)&pClientContextMap);
CHECK_HR(hr, "Failed to get Contextmap from WDF File Object");
}
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |