Función IoCsqInitialize (wdm.h)

Artículo
02/27/2024

La rutina IoCsqInitialize inicializa la tabla de distribución de cola irP segura para cancelación del controlador.

Sintaxis

NTSTATUS IoCsqInitialize(
  [out] PIO_CSQ                       Csq,
  [in]  PIO_CSQ_INSERT_IRP            CsqInsertIrp,
  [in]  PIO_CSQ_REMOVE_IRP            CsqRemoveIrp,
  [in]  PIO_CSQ_PEEK_NEXT_IRP         CsqPeekNextIrp,
  [in]  PIO_CSQ_ACQUIRE_LOCK          CsqAcquireLock,
  [in]  PIO_CSQ_RELEASE_LOCK          CsqReleaseLock,
  [in]  PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);

Parámetros

[out] Csq

Puntero a la estructura de IO_CSQ que IoCsqInitialize va a inicializar.

[in] CsqInsertIrp

Puntero a la función CsqInsertIrp definida por el controlador para la cola IRP con seguridad de cancelación del controlador.

[in] CsqRemoveIrp

Puntero a la función CsqRemoveIrp definida por el controlador para la cola IRP con seguridad de cancelación del controlador.

[in] CsqPeekNextIrp

Puntero a la función CsqPeekNextIrp definida por el controlador para la cola IRP con seguridad de cancelación del controlador.

[in] CsqAcquireLock

Puntero a la función CsqAcquireLock definida por el controlador para la cola IRP segura para cancelación del controlador.

[in] CsqReleaseLock

Puntero a la función CsqReleaseLock definida por el controlador para la cola IRP segura para cancelar el controlador.

[in] CsqCompleteCanceledIrp

Puntero a la función CsqCompleteCanceledIrp definida por el controlador para la cola IRP con seguridad de cancelación del controlador.

Valor devuelto

Esta rutina devuelve STATUS_SUCCESS si se ejecuta correctamente o el código de error NTSTATUS adecuado en caso de error.

Comentarios

La rutina IoCsqInitialize inicializa una estructura de IO_CSQ que describe la cola irP segura para cancelación de un controlador. Los controladores también pueden usar IoCsqInitializeEx para crear una cola IRP con funcionalidades extendidas. Para obtener más información, consulte Cancel-Safe IRP Queues( Colas irP seguras para cancelar).

Tenga en cuenta que las rutinas IoCsqXxx usan el miembro DriverContext[3] del IRP para contener información de contexto de IRP. Los controladores que usan estas rutinas para poner en cola los IRP deben dejar ese miembro sin usar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows XP y versiones posteriores del sistema operativo Windows. Los controladores que también deben funcionar para Windows 2000 y Windows 98/Me pueden vincular a Csq.lib para usar la rutina.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	Cualquier nivel