ExTryConvertSharedSpinLockExclusive 函式 (wdm.h)

發行項
02/27/2024

ExTryConvertSharedSpinLockExclusive 例程會嘗試從取得的微調鎖定存取狀態，將共用存取權轉換為獨佔存取。

語法

LOGICAL ExTryConvertSharedSpinLockExclusive(
  [in, out] PEX_SPIN_LOCK SpinLock
);

參數

[in, out] SpinLock

微調鎖定的指標，其存取狀態要轉換成獨佔存取。呼叫端必須已經擁有此微調鎖定，才能進行共用存取。

傳回值

如果轉換成功，ExTryConvertSharedSpinLockExclusive 會傳回 TRUE;否則會傳回 FALSE。

備註

如果呼叫端藉由呼叫 ExAcquireSpinLockSharedAtDpcLevel 例程取得共用微調鎖定，呼叫端應該呼叫 ExReleaseSpinLockExclusiveFromDpcLevel 例程來釋放轉換的微調鎖定。如果呼叫端藉由呼叫 ExAcquireSpinLockShared 例程取得共用微調鎖定，呼叫端應該呼叫 ExReleaseSpinLockExclusive 例程來釋放轉換的微調鎖定，而提供做為此例程輸入參數的 OldIrql 值應該是 ExAcquireSpinLockShared 所傳回的 KIRQL 值。