Función NdisAcquireRWLockWrite (ndis.h)

Artículo
02/07/2025

La función NdisAcquireRWLockWrite obtiene un bloqueo de escritura que el autor de la llamada usa para el acceso de escritura a los recursos que se comparten entre subprocesos de controlador.

Sintaxis

void NdisAcquireRWLockWrite(
  [in]  PNDIS_RW_LOCK_EX Lock,
  [out] PLOCK_STATE_EX   LockState,
  [in]  UCHAR            Flags
);

Parámetros

[in] Lock

Puntero a una variable NDIS_RW_LOCK_EX opaca que representa un bloqueo. El autor de la llamada puede usar este bloqueo para obtener acceso de escritura o lectura a los recursos que se comparten entre subprocesos de controladores que no son ISR.

[out] LockState

Puntero a una variable LOCK_STATE_EX opaca que realiza un seguimiento del estado del bloqueo. Esta variable existe en el intervalo entre las veces que el autor de la llamada obtiene y libera el bloqueo. El autor de la llamada debe usar una variable diferente de tipo LOCK_STATE_EX para cada intento que realice para obtener el bloqueo del mismo subproceso de controlador que no es ISR.

[in] Flags

Valor ULONG que contiene marcas de bloqueo. Establezca este parámetro en NDIS_RWL_AT_DISPATCH_LEVEL si el IRQL actual del autor de la llamada está DISPATCH_LEVEL. De lo contrario, establezca este parámetro en cero. Para obtener más información sobre cómo enviar el seguimiento de IRQL, consulte Dispatch IRQL Tracking.

Nota Si el autor de la llamada sabe que irQL actual está DISPATCH_LEVEL, establezca este parámetro en NDIS_RWL_AT_DISPATCH_LEVEL. Esta marca hace que el bloqueo sea aún más eficaz al hacer que se omita una comprobación para el IRQL actual. Si el IRQL actual es desconocido, no pruebe el IRQL actual con KeGetCurrentIrql únicamente para determinar si se debe establecer esta marca, ya que es más eficaz permitir que el NdisAcquireRWLockWrite función para probar el IRQL en sí.

Valor devuelto

Ninguno

Observaciones

Los controladores NDIS llaman a la función NdisAcquireRWLockWrite para modificar los recursos que se comparten entre subprocesos de controlador.

El controlador debe asignar una variable de tipo NDIS_RW_LOCK_EX con la función NdisAllocateRWLock antes de que el controlador llame a la función NdisAcquireRWLockWrite. El controlador debe proporcionar un identificador para NdisAllocateRWLock para el almacenamiento residente para los bloqueos que usa.

Una vez que el controlador llama a NdisAllocateRWLock, puede llamar a NdisAcquireRWLockWrite o NdisAcquireRWLockRead para obtener acceso de escritura o lectura al recurso. Solo un subproceso de controlador que no es ISR puede obtener acceso de escritura al recurso. Cuando un subproceso que no es ISR tiene acceso de escritura, todos los accesos de lectura y escritura por otros subprocesos que no son ISR deben esperar hasta que el titular del acceso de escritura libere el bloqueo. Sin embargo, si un subproceso que no es ISR tiene acceso de lectura, otros subprocesos que no son ISR pueden obtener acceso de lectura simultáneamente.

El bloqueo de NDIS_RW_LOCK_EX no admite la promoción de lectura a escritura. Una vez que un procesador ha adquirido un NDIS_RW_LOCK_EX para el acceso de lectura (llamando a NdisAcquireRWLockRead), el mismo procesador no debe intentar adquirir acceso de escritura (llamando a NdisAcquireRWLockWrite) hasta que se libere el acceso de lectura anterior.

Un NDIS_RW_LOCK_EX bloqueo de escritura se puede adquirir de forma recursiva en el mismo procesador. Para cada llamada a NdisAcquireRWLockWrite, debe haber una llamada correspondiente a NdisReleaseRWLock. El bloqueo solo se libera después de la última llamada a NdisReleaseRWLock.

Un subproceso de controlador nunca debe contener un bloqueo de escritura para más de unos pocos microsegundos. Mantener un bloqueo de escritura durante un período prolongado de tiempo degrada el rendimiento del sistema operativo y del controlador.

El controlador no puede usar un bloqueo para proteger los recursos del acceso de lectura o escritura que comparten sus otras funciones con el MiniportInterrupt o funciones de MiniportDisableInterruptEx o ambas. En su lugar, el controlador debe llamar a NdisMSynchronizeWithInterruptEx para que su función MiniportSynchronizeInterrupt accede a estos recursos compartidos en el mismo DIRQL que su MiniportInterrupt o funciones de miniportDisableInterruptEx, o ambas, sí.

NdisAcquireRWLockWrite eleva irQL a DISPATCH_LEVEL obteniendo un bloqueo de giro.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.20 y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	<= DISPATCH_LEVEL