Función FsRtlAllocateAePushLock (ntifs.h)

FsRtlAllocateAePushLock asigna e inicializa un bloqueo de inserción de expansión automática.

Sintaxis

PVOID FsRtlAllocateAePushLock(
  [in] POOL_TYPE PoolType,
  [in] ULONG     Tag
);

Parámetros

[in] PoolType

Tipo de memoria del grupo que se va a asignar para el bloqueo de inserción de expansión automática. Consulte POOL_TYPE para obtener una descripción de los tipos de memoria del grupo disponibles. Puede modificar el valor PoolType mediante ORing bit a bit con la marca POOL_RAISE_IF_ALLOCATION_FAILURE. Esta marca hace que se genere una excepción si no se puede satisfacer la solicitud de asignación.

[in] Tag

Etiqueta de grupo que se va a usar para la memoria asignada. Especifique la etiqueta de grupo como un literal de carácter distinto de cero de uno a cuatro caracteres delimitados por comillas simples (por ejemplo, "Tag1"). Normalmente, la cadena se especifica en orden inverso (por ejemplo, "1gaT"). Cada carácter ASCII de la etiqueta debe ser un valor del intervalo 0x20 (espacio) para 0x7E (tilde). Cada ruta de acceso de código de asignación debe usar una etiqueta de grupo única para ayudar a los depuradores y comprobadores a identificar la ruta de acceso del código.

Valor devuelto

FsRtlAllocateAePushLock devuelve NULL si no hay memoria suficiente en el grupo libre para satisfacer la solicitud. De lo contrario, la rutina devuelve un puntero al bloqueo de inserción de expansión automática asignado e inicializado.

Comentarios

FsRtlAllocateAePushLock se usa para asignar memoria del grupo para un bloqueo de inserción de expansión automática. Consulte FSRTL_ADVANCED_FCB_HEADER para obtener más información sobre los bloqueos de inserción de expansión automática.

El sistema asocia la etiqueta de grupo a la memoria asignada. Las herramientas de programación, como WinDbg, pueden mostrar la etiqueta de grupo asociada a cada búfer asignado. Gflags, una herramienta incluida en Herramientas de depuración para Windows, activa una característica del sistema que solicita la asignación de un grupo especial para una etiqueta de grupo determinada. Poolmon, que se incluye en el WDK, realiza un seguimiento de la memoria por etiqueta de grupo.

El autor de la llamada de FsRtlAllocateAePushLock debe llamar posteriormente a FsRtlFreeAePushLock para liberar el bloqueo de inserción de expansión automática asignado.

El sistema establece automáticamente determinados objetos de evento estándar cuando la cantidad de grupo (paginada o no paginada) es alta o baja. Los controladores pueden esperar a que estos eventos ajusten su uso del grupo. Para obtener más información, vea Objetos de eventos estándar.

Requisitos

Consulte también

FSRTL_ADVANCED_FCB_HEADER

FsRtlFreeAePushLock

FsRtlSetupAdvancedHeaderEx2