Función KsMoveIrpsOnCancelableQueue (ks.h)

La función KsMoveIrpsOnCancelableQueue mueve los IRP especificados desde el parámetro SourceList al parámetro DestinationList según el valor devuelto por la función KStrIrpListCallback definida por el minidriver.

Sintaxis

KSDDKAPI NTSTATUS KsMoveIrpsOnCancelableQueue(
  [in, out]      PLIST_ENTRY           SourceList,
  [in]           PKSPIN_LOCK           SourceLock,
  [in, out]      PLIST_ENTRY           DestinationList,
  [in, optional] PKSPIN_LOCK           DestinationLock,
  [in]           KSLIST_ENTRY_LOCATION ListLocation,
  [in]           PFNKSIRPLISTCALLBACK  ListCallback,
  [in]           PVOID                 Context
);

Parámetros

[in, out] SourceList

Especifica el encabezado de la cola de la que se van a quitar los IRP.

[in] SourceLock

Puntero al bloqueo de número del controlador para el acceso a la cola de origen.

[in, out] DestinationList

Especifica el encabezado de la cola en la que se van a agregar los IRP.

[in, optional] DestinationLock

Opcionalmente, contiene un puntero al bloqueo de número del controlador para el acceso a la cola de destino. Si no se proporciona, se supone que el parámetro SourceLock controla ambas colas. Si se proporciona, este bloqueo siempre se adquiere después del parámetro SourceLock . Si la lista de destino tiene un bloqueo de número independiente, primero se adquiere el bloqueo de número de cancelación en todo el sistema para mover IRP y permitir que se actualice el bloqueo de giro de KSQUEUE_SPINLOCK_IRP_STORAGE().

[in] ListLocation

Indica si los IRP deben enumerarse desde el encabezado o la cola de la cola de origen. Los IRP que se mueven se colocan en el extremo opuesto de la cola de destino para que se mantenga la ordenación.

[in] ListCallback

Especifica la función KStrIrpListCallback definida por el minidriver para indicar si se debe mover un IRP específico de SourceList a DestinationList o si se debe finalizar la enumeración.

[in] Context

Contexto pasado a ListCallback.

Valor devuelto

Devuelve STATUS_SUCCESS si la lista se ha enumerado por completo; de lo contrario, devuelve cualquier advertencia o error devuelto por la función de devolución de llamada KStrIrpListCallback definida por el minidriver que interrumpió la enumeración.

Comentarios

Un IRP se mueve si la función KStrIrpListCallback indica que se debe mover, si se adquiere actualmente. Si KStrIrpListCallback devuelve STATUS_SUCCESS, el IRP se mueve. Si devuelve STATUS_NO_MATCH, el IRP no se mueve. Cualquier otra advertencia de devolución o valor de error finalizará la enumeración y la función devolverá. KStrIrpListCallback no debe devolver el valor STATUS_NO_MATCH como error. Se llama a KStrIrpListCallback en DISPATCH_LEVEL. KStrIrpListCallback siempre se llama al menos una vez al final con un valor IRP NULL para completar la enumeración de lista.

KsMoveIrpsOnCancelableQueue continúa a través de la lista hasta que la función de devolución de llamada indica que se debe finalizar la búsqueda o se alcanza el final de la lista. KsMoveIrpsOnCancelableQueue minimiza el uso del bloqueo de número de cancelación de todo el sistema mediante los bloqueos de giro proporcionados para sincronizar el acceso cuando sea posible. KsMoveIrpsOnCancelableQueue no permite modificar la rutina de cancelación al mover IRP.

Se puede llamar a la función en DISPATCH_LEVEL o inferior.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ks.h (incluya Ks.h)
Library	Ks.lib

Consulte también

KStrIrpListCallback