NdisAcquireRWLockWrite 函式 (ndis.h)
NdisAcquireRWLockWrite 函式會取得呼叫端用於驅動程式線程之間共用資源的寫入鎖定。
語法
void NdisAcquireRWLockWrite(
[in] PNDIS_RW_LOCK_EX Lock,
[out] PLOCK_STATE_EX LockState,
[in] UCHAR Flags
);
參數
[in] Lock
代表鎖定的不透明 NDIS_RW_LOCK_EX 變數指標。 呼叫端可以使用此鎖定來取得非ISR驅動程式線程之間共用資源的寫入或讀取許可權。
[out] LockState
追蹤鎖定狀態的不透明 LOCK_STATE_EX 變數指標。 此變數存在於呼叫端取得和釋放鎖定的時間之間的間隔。 呼叫端必須針對每次嘗試從相同的非ISR驅動程式線程取得鎖定時，使用不同的類型變數 LOCK_STATE_EX 。
[in] Flags
包含鎖定旗標的 ULONG 值。 如果呼叫端目前的 IRQL 已DISPATCH_LEVEL，請將此參數設定為 NDIS_RWL_AT_DISPATCH_LEVEL。 否則，請將此參數設定為零。 如需分派 IRQL 追蹤的詳細資訊，請參閱 分派 IRQL 追蹤。
傳回值
無
備註
NDIS 驅動程式會呼叫 NdisAcquireRWLockWrite 函式，以修改驅動程式線程之間共用的資源。
驅動程式必須在驅動程式呼叫 NdisAcquireRWLockWrite 函式之前，使用 NdisAllocateRWLock 函式來配置類型NDIS_RW_LOCK_EX變數。 驅動程式必須提供 NdisAllocateRWLock 的句柄，以供其使用之鎖定的駐留記憶體使用。
在驅動程式呼叫 NdisAllocateRWLock 之後，它可以呼叫 NdisAcquireRWLockWrite 或 NdisAcquireRWLockRead ，以取得資源的寫入或讀取許可權。 一次只有一個非ISR驅動程式線程可以取得資源的寫入許可權。 當一個非ISR線程具有寫入許可權時，其他非ISR線程的所有讀取和寫入存取都必須等到寫入許可權持有者釋放鎖定為止。 不過，如果非ISR線程具有讀取許可權，其他非ISR線程可以同時取得讀取許可權。
NDIS_RW_LOCK_EX鎖定不支援從讀取到寫入升級。 一旦處理器藉由呼叫 NdisAcquireRWLockRead) 取得讀取存取 (NDIS_RW_LOCK_EX，相同的處理器便不能透過呼叫 NdisAcquireRWLockWrite) 來嘗試取得寫入存取權 (，直到發行先前的讀取存取權為止。
在相同的處理器上，可以遞歸方式取得 NDIS_RW_LOCK_EX 寫入鎖定。 對於 NdisAcquireRWLockWrite 的每個呼叫，必須有 對應的 NdisReleaseRWLock 呼叫。 只有在上次呼叫 NdisReleaseRWLock 之後，才會釋放鎖定。
驅動程式線程絕對不應該保留一些微秒以上的寫入鎖定。 長時間保留寫入鎖定會降低操作系統和驅動程式效能。
驅動程式無法使用鎖定來保護資源，使其其他函式與 MiniportInterrupt 共用的讀取或寫入存取權 MiniportDisableInterruptEx 函式或兩者。 相反地，驅動程式必須呼叫 NdisMSynchronizeWithInterruptEx ，使其 MiniportSynchronizeInterrupt 函式會在其 MiniportInterrupt 或相同的 DIRQL 存取這類共用資源 MiniportDisableInterruptEx 函式或兩者皆可執行。
NdisAcquireRWLockWrite 會藉由取得微調鎖定來引發 IRQL 以 DISPATCH_LEVEL 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.20 和更新版本支援。 |
| 目標平台 | Universal |
| 標頭 | ndis.h (包括 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |