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 de 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.
Observaciones
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 grupo especial para una etiqueta de grupo determinada. Poolmon, que se incluye en WDK, realiza un seguimiento de la memoria por etiqueta de grupo.
El autor de la llamada de FsRtlAllocateAePushLock posteriormente debe llamar 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 el uso del grupo. Para obtener más información, vea Standard Event Objects.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 20H2 |
| encabezado de |
ntifs.h |
| irQL | <= APC_LEVEL |