Método IWDFIoRequest::GetInputMemory (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 GetInputMemory recupera el objeto de memoria que representa el búfer de entrada en una solicitud de E/S.
Sintaxis
void GetInputMemory(
[out] IWDFMemory **ppWdfMemory
);
Parámetros
[out] ppWdfMemory
Puntero a una variable que recibe un puntero al IWDFMemory con recuento de referencias interfaz para el objeto de memoria. Tenga en cuenta que devolver NULL es válido; en esta situación, no hay memoria de entrada asociada a la solicitud de E/S.
Valor devuelto
Ninguno
Observaciones
Los controladores que usan el método de acceso de E/S almacenado en búfer pueden llamar a GetInputMemory para obtener el búfer de entrada de una solicitud de E/S.
Antes de que un controlador complete una solicitud de E/S, el controlador debe llamar al método IWDFMemory::Release para el objeto de memoria. El objeto de memoria subyacente se libera cuando se completa la solicitud.
El búfer de entrada asociado a la solicitud de E/S contiene información (por ejemplo, los datos que se van a escribir en un disco) que el originador de la solicitud proporcionada. El controlador puede llamar a GetInputMemory para obtener el búfer de entrada para una solicitud de escritura o una solicitud de control de E/S del dispositivo, pero no para una solicitud de lectura (porque las solicitudes de lectura no proporcionan datos de entrada). Para acceder al búfer de entrada, el controlador debe llamar al método IWDFMemory::GetDataBuffer.
UMDF crea los objetos de memoria de una solicitud de E/S cuando recibe la solicitud de E/S antes de agregar la solicitud de E/S a la cola de E/S de un controlador. Si UMDF no puede asignar memoria para los objetos de memoria, completa la solicitud de E/S con un estado de devolución de error y no entrega la solicitud de E/S al controlador.
Para obtener más información sobre el acceso a los búferes de datos de una solicitud de E/S, consulte acceder a búferes de datos en controladores de UMDF-Based.
Ejemplos
Para obtener un ejemplo de código de cómo usar el método GetInputMemory, vea IWDFIoRequest::Complete.
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 |