Función FsRtlInitExtraCreateParameterLookasideList (ntifs.h)
La rutina FsRtlInitExtraCreateParameterLookasideList inicializa una lista de búsqueda de grupo paginada o no paginada usada para la asignación de una o varias estructuras de contexto de parámetros de creación adicional (ECP) de tamaño fijo.
Sintaxis
void FsRtlInitExtraCreateParameterLookasideList(
[in, out] PVOID Lookaside,
[in] FSRTL_ECP_LOOKASIDE_FLAGS Flags,
[in] SIZE_T Size,
[in] ULONG Tag
);
Parámetros
[in, out] Lookaside
Puntero a un PAGED_LOOKASIDE_LIST opaco o NPAGED_LOOKASIDE_LIST estructura de la cabeza de lista de aspecto. Para una lista de búsqueda paginada o no paginada, la estructura de encabezado de lista debe asignarse desde un grupo no paginado.
[in] Flags
Define las opciones de asignación del grupo. Si el parámetro Flags contiene el valor de marca de bits de FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, FsRtlInitExtraCreateParameterLookasideList inicializa una lista de lookaside para las entradas ECP no paginadas del tamaño especificado. De lo contrario, FsRtlInitExtraCreateParameterLookasideList inicializa una lista de lookaside para las entradas ECP paginadas del tamaño especificado.
[in] Size
Especifica el tamaño, en bytes, para todas las entradas ECP de la lista lookaside.
[in] Tag
Especifica la etiqueta de grupo que se va a usar al asignar entradas ECP de lista de lookaside. Para obtener más información sobre las etiquetas de grupo, consulte el parámetro Tag de ExAllocatePoolWithTag.
Valor devuelto
None
Observaciones
Use esta rutina para inicializar una lista de búsqueda de grupo paginada o no paginada. Use la rutina FsRtlAllocateExtraCreateParameterFromLookasideList para asignar un ECP de la lista de lookaside y la rutina FsRtlFreeExtraCreateParameter para devolver un búfer ECP a la lista de aspecto para su reciclaje.
Use la rutina FsRtlDeleteExtraCreateParameterLookasideList para liberar la propia lista de aspecto.
Los controladores deben liberar todas las ECP y las listas de búsqueda que crean antes de descargarlas.
Para obtener más información sobre el uso de listas de búsqueda con controladores, consulte Uso de lookaside Listas.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | La rutina FsRtlInitExtraCreateParameterLookasideList está disponible a partir de Windows Vista. |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Consulte también
FsRtlAllocateExtraCreateParameterFromLookasideList