Método IWDFIoRequest::GetInputMemory (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 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 a la interfaz IWDFMemory con recuento de referencias 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

None

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 proporcionó. 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 de 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 Acceso a los búferes de datos en controladores de UMDF-Based.

Ejemplos

Para obtener un ejemplo de código sobre cómo usar el método GetInputMemory , vea IWDFIoRequest::Complete.

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

Consulte también

IWDFIoRequest

IWDFIoRequest::Complete

IWDFMemory

IWDFMemory::GetDataBuffer