Función NdisAcquireRWLockRead (ndis.h)
La función NdisAcquireRWLockRead obtiene un bloqueo de lectura que el autor de la llamada usa para el acceso de lectura a los recursos que se comparten entre subprocesos de controlador.
Sintaxis
void NdisAcquireRWLockRead(
[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.
Valor devuelto
Ninguno
Observaciones
Los controladores NDIS llaman a la función NdisAcquireRWLockRead para obtener acceso de solo lectura a 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 NdisAcquireRWLockRead.
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 lectura se puede adquirir de forma recursiva en el mismo procesador. Para cada llamada a NdisAcquireRWLockRead, debe haber una llamada correspondiente a NdisReleaseRWLock. El bloqueo solo se libera después de la última llamada a NdisReleaseRWLock.
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 función 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.
NdisAcquireRWLockRead siempre genera irQL a IRQL = DISPATCH_LEVEL.
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 |