FsRtlOplockGetAnyBreakOwnerProcess 函式 (ntifs.h)

  • 發行項

FsRtlOplockGetAnyBreakOwnerProcess 會 (oplock) 傳回重大商機鎖定的擁有者。

語法

PEPROCESS FsRtlOplockGetAnyBreakOwnerProcess(
  POPLOCK Oplock
);

參數

Oplock

檔案不透明不透明鎖定結構的指標。 此指標必須由先前呼叫 FsRtlInitializeOplock 來初始化。

傳回值

如果找不到擁有者，這個方法會傳回 NULL ;否則它會傳回擁有者進程物件的指標， (PEPROCESS) 。

備註

FsRtlOplockGetAnyBreakOwnerProcess 會選取重大 oplock 的擁有者，如下所示：

  • 如果 oplock 具有獨佔擁有者， FsRtlOplockGetAnyBreakOwnerProcess 會傳回獨佔擁有者 EPROCESS 的指標。

  • 如果 oplock 沒有獨佔擁有者，而且中斷佇列非空白， FsRtlOplockGetAnyBreakOwnerProcess 會任意傳回佇列中第一個 EPROCESS 的指標。

  • 否則， FsRtlOplockGetAnyBreakOwnerProcess 會傳回 NULL。

如果 FsRtlOplockGetAnyBreakOwnerProcess 傳回非 NULL，則呼叫端會負責呼叫 ObDeferenceObject ，以代表其釋放取得的參考。

FsRtlOplockGetAnyBreakOwnerProcess 不會嘗試驗證中斷確實擱置中，或傳回的進程確實是擁有者。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 2004)
標頭 ntifs.h

另請參閱

FsRtlInitializeOplock

ObDeferenceObject