Función MmLockPagableSectionByHandle (ntddk.h)

Artículo
08/07/2023

La rutina MmLockPagableSectionByHandle bloquea un código paginable o una sección de datos en la memoria del sistema incrementando el recuento de referencias en el identificador de la sección.

Sintaxis

void MmLockPagableSectionByHandle(
  [in] PVOID ImageSectionHandle
);

Parámetros

[in] ImageSectionHandle

Identificador de una sección de datos o código paginable. El llamador obtuvo este identificador de una llamada anterior a la rutina MmLockPagableCodeSection o MmLockPagableDataSection .

Valor devuelto

None

Observaciones

Un controlador llama inicialmente a MmLockPagableCodeSection o MmLockPagableDataSection para obtener un identificador de una sección de datos o código paginable. A partir de entonces, el controlador puede llamar a MmLockPagableSectionByHandle y MmUnlockPagableImageSection para incrementar y disminuir el recuento de referencias en el identificador.

La llamada MmLockPagableCodeSection o MmLockPagableDataSection bloquea la sección paginable en la memoria del sistema, devuelve un identificador a la sección e inicializa el recuento de referencias en el identificador en uno. MmLockPagableSectionByHandle incrementa el recuento de referencias en uno y MmUnlockPagableImageSection disminuye el recuento de referencias en uno.

Si el recuento de referencias del identificador es distinto de cero, la sección paginable se bloquea. Si el recuento de referencias es cero, se desbloquea la sección.

El identificador de la sección paginable sigue siendo válido siempre que el controlador permanezca cargado en la memoria. El controlador puede usar el mismo controlador para bloquear y desbloquear repetidamente la sección. Es decir, el controlador puede reutilizar un identificador cuyo recuento de referencias es cero. MmLockPagableSectionByHandle comprueba si la sección a la que se hace referencia reside en el espacio de direcciones del autor de la llamada y, si es así, simplemente incrementa el recuento de referencias en la sección. Si la sección no es residente, las páginas MmLockPagableSectionByHandle de la sección, las bloquea en el espacio del sistema y establece el recuento de referencias en uno.

Para evitar la pérdida de memoria del sistema, el recuento de referencias del identificador debe ser cero cuando el controlador se descarga de la memoria. De lo contrario, la sección paginable permanecerá bloqueada en la memoria del sistema después de que el controlador se descargue.

Si el controlador se prepara para descargar y el recuento de referencias del identificador es distinto de cero, el controlador debe llamar a MmUnlockPagableImageSection para reducir el recuento en cero antes de que se produzca la descarga.

Un controlador no puede llamar a MmLockPagableSectionByHandle para bloquear los búferes de usuario pasados en irP. En su lugar, use MmProbeAndLockPages .

Para obtener más información sobre el código de paginación y los datos, vea Hacer que los controladores sean paginables.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	ntddk.h (incluya Ntddk.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), IrqlMmApcLte(wdm)