Función KeInsertQueue (ntifs.h)
La rutina KeInsertQueue inserta una entrada en la cola de la cola especificada si no puede usar inmediatamente la entrada para satisfacer una espera de subproceso.
Sintaxis
LONG KeInsertQueue(
[in, out] PRKQUEUE Queue,
[in, out] PLIST_ENTRY Entry
);
Parámetros
[in, out] Queue
Puntero a un objeto de cola inicializado para el que el autor de la llamada proporciona almacenamiento residente en un grupo no paginado.
[in, out] Entry
Puntero a una entrada que se va a poner en cola. Este puntero debe ser una dirección de espacio del sistema residente.
Valor devuelto
KeInsertQueue devuelve el estado de señal anterior de la cola especificada. Si se estableció en cero (es decir, no se señalizó) antes de llamar a KeInsertQueue , KeInsertQueue devuelve cero, lo que significa que no se ponen en cola entradas. Si era distinto de cero (señalado), KeInsertQueue devuelve el número de entradas que se ponen en cola antes de llamar a KeInsertQueue .
Comentarios
Las entradas que KeInsertQueue debe poner en cola deben asignarse desde un grupo no paginado. Por ejemplo, la memoria de las entradas definidas por el autor de la llamada se puede asignar con ExAllocatePoolWithTag. Si el autor de la llamada asigna entradas de un tamaño fijo, la creación de una lista de lookaside con ExInitializeNPagedLookasideList y la asignación desde ella con ExAllocateFromNPagedLookasideList es más eficaz que realizar llamadas frecuentes a ExAllocatePoolWithTag, especialmente para las entradas cuyo tamaño no es un múltiplo de PAGE_SIZE.
Si algún subproceso está esperando en el objeto de cola cuando se llama a KeInsertQueue , esta llamada satisface la espera de un único subproceso. El subproceso se envía para su ejecución con el puntero entry especificado.
Si no hay subprocesos actualmente en espera en el objeto de cola cuando se llama a KeInsertQueue , la entrada especificada se inserta en la cola y se incrementa el estado de señal del objeto de cola.
Para más información sobre el uso de colas internas administradas por controladores, consulte Colas administradas por controladores.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport) |
Consulte también
ExAllocateFromNPagedLookasideList