Función CopyFromModeNonTemporales (usermode_accessors.h)

La función CopyFromModeNonTemporales copia de forma segura los datos de la memoria del kernel o del modo de usuario a la memoria kernel mediante instrucciones no temporales basadas en el modo de procesador especificado.

Syntax

VOID CopyFromModeNonTemporal(
  VOID            *Destination,
  const VOID      *Source,
  SIZE_T          Length,
  KPROCESSOR_MODE Mode
);

Parameters

Destination

[out] Puntero a la ubicación de memoria del kernel donde se copiarán los datos.

Source

[in] Puntero a la ubicación de memoria desde la que se van a copiar los datos.

Length

[in] Número de bytes que se van a copiar.

Mode

[in] Modo de procesador que determina cómo se realiza el acceso a la memoria. El modo puede ser uno de los siguientes valores.

Valor devuelto

None

Remarks

Esta función proporciona una manera segura de copiar datos de memoria del kernel o del modo de usuario a la memoria del kernel mediante instrucciones no temporales (streaming), con el mecanismo de copia determinado por el modo de procesador especificado. Esto permite operaciones de memoria flexibles que se pueden adaptar a diferentes contextos de ejecución, al tiempo que optimiza el rendimiento de la memoria caché para transferencias de datos de gran tamaño.

Cuando el modo es KernelMode:

• La función realiza una copia volátil mediante memory_order_relaxed semántica con instrucciones no temporales.

• La función no se reconoce como intrínseca del compilador, por lo que el compilador nunca optimizará la llamada (por completo o reemplazará la llamada por una secuencia equivalente de instrucciones).

• Cuando se devuelve la llamada, los datos se han copiado de Origen a Destino. El acceso a la memoria de esta función al origen y el destino solo se realizará dentro de la función (por ejemplo, el compilador no puede mover los accesos de memoria fuera de esta función).

• La función puede realizar accesos a memoria no asignadas si la plataforma lo permite.

• La función puede tener acceso a ubicaciones de memoria más de una vez como parte de su operación de copia.

• La función no admite operaciones de copia cuando origen y destino se superponen entre sí.

• La función usa instrucciones no temporales que pueden mejorar el rendimiento de las transferencias de datos de gran tamaño pasando la memoria caché del procesador, lo que reduce la contaminación de la memoria caché.

Esta función es especialmente útil al copiar grandes cantidades de datos a los que es poco probable que se vuelva a acceder pronto, ya que evita expulsar otros datos útiles de la memoria caché.

Si va a copiar desde una estructura de tamaño fijo, debe usar ReadStructFromMode en su lugar para evitar el riesgo de pasar el tamaño incorrecto.

El compilador nunca optimizará esta función ni creará accesos adicionales a esta ubicación de memoria antes de llamar a la función o después de que se devuelva la función (a menos que el código fuente realice explícitamente estos accesos).

Esta función funciona en todas las versiones de Windows, no solo en la más reciente. Debe consumir el WDK más reciente para obtener la declaración de función del encabezado usermode_accessors.h . También necesita la biblioteca (umaccess.lib) del WDK más reciente. Sin embargo, el controlador resultante se ejecutará correctamente en versiones anteriores de Windows.

Requirements

Consulte también

CopyFromMode

CopyFromUserNonTemporales

CopyToModeNonTemporales