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 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 GetFileObject 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
None
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 disminuya 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 el WDK. En el ejemplo se declara un puntero inteligente a una interfaz IWDFFile , se llama a GetFileObject y, a continuación, se 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 | 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.5 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |