共用方式為


ntGetNotificationResourceManager 函式 (wdm.h)

ZwGetNotificationResourceManager 例程會從指定的資源管理員通知佇列擷取下一個交易通知

語法

__kernel_entry NTSYSCALLAPI NTSTATUS NtGetNotificationResourceManager(
  [in]            HANDLE                    ResourceManagerHandle,
  [out]           PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]            ULONG                     NotificationLength,
  [in]            PLARGE_INTEGER            Timeout,
  [out, optional] PULONG                    ReturnLength,
  [in]            ULONG                     Asynchronous,
  [in, optional]  ULONG_PTR                 AsynchronousContext
);

參數

[in] ResourceManagerHandle

先前呼叫 ZwCreateResourceManagerZwOpenResourceManager 取得的資源管理員物件的句柄。 句柄必須具有物件的RESOURCEMANAGER_GET_NOTIFICATION存取權。

[out] TransactionNotification

呼叫端配置的緩衝區指標,可接收所擷取通知的相關信息。 緩衝區必須夠大,才能包含 TRANSACTION_NOTIFICATION 結構加上額外的通知特定自變數。

[in] NotificationLength

TransactionNotification 參數指向的緩衝區長度,以位元組為單位。

[in] Timeout

值的指標,指定相對時間或絕對時間,單位為100奈秒。 此指標是選擇性的,而且可以是 NULL

如果指標為 NULL,則在交易通知可用之前, ZwGetNotificationResourceManager 不會傳回。 如果指定時間值, 則 ZwGetNotificationResourceManager 會在通知可用時傳回,或是在指定的時間經過之後傳回,以第一個為準。

負值會指定相對於目前系統時間的時間。 例如,相對時間值為 5 秒,會導致 ZwGetNotificationResourceManager 在呼叫後逾時五秒。

正值會指定絕對時間,這實際上相對於 00:00,1601 年 1 月 1 日。 如果指定絕對時間值,操作系統會將絕對時間值新增至代表 00:00、1601 年 1 月 1 日的時間值。

如果呼叫端指定零值, (而不是 NULL 指標) , 則 ZwGetNotificationResourceManager 會立即傳回通知,無論通知是否可用。

[out, optional] ReturnLength

變數的選擇性指標。 如果這個指標不是 NULL,而且 NotificationLength 參數的值太小, ZwGetNotificationResourceManager 會在變數中提供所需的長度,並傳回STATUS_BUFFER_TOO_SMALL。

[in] Asynchronous

必須是零的 ULONG 值。 ZwGetNotificationResourceManager 不支持異步通知。 使用 TmEnableCallbacks 來啟用異步通知。

[in, optional] AsynchronousContext

ULONG 值的指標。 此指標必須是 NULL

傳回值

如果作業成功且有通知可用,ZwGetNotificationResourceManager 會傳回STATUS_SUCCESS。 否則,此例程可能會傳回下列其中一個值:

傳回碼 Description
STATUS_TIMEOUT
Timeout 指定在通知可用之前經過的超時時間間隔。
STATUS_OBJECT_TYPE_MISMATCH
指定的句柄不是 Resource Manager 物件的句柄。
STATUS_INVALID_HANDLE
物件句柄無效。
STATUS_ACCESS_DENIED
呼叫端沒有資源管理員對象的適當存取權。
STATUS_BUFFER_TOO_SMALL
NotificationLength 參數的值太小。
 

例程可能會傳回其他 NTSTATUS值

備註

使用 ZwGetNotificationResourceManager 例程以同步方式取得通知。 使用 TmEnableCallbacks 例程來啟用異步通知。

收到的 TRANSACTION_NOTIFICATION 結構包含資源管理員在呼叫 ZwCreateEnlistment 時所指定的登記索引鍵。 您可以使用登記索引鍵來識別通知所套用的登記。

如需 ZwGetNotificationResourceManager 例程的詳細資訊,請參閱建立 Resource Manager

NtGetNotificationResourceManagerZwGetNotificationResourceManager 是相同 Windows 原生系統服務例程的兩個版本。

針對來自內核模式驅動程式的呼叫,Windows 原生系統服務例程的 NtXxxZwXxx 版本會以處理和解譯輸入參數的方式,以不同的方式運作。 如需 例程 NtXxxZwXxx 版本之間關聯性的詳細資訊,請參閱 使用原生系統服務例程的 Nt 和 Zw 版本

規格需求

需求
最低支援的用戶端 適用於 Windows Vista 和更新版本的作業系統版本。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL = PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs、PowerIrpDDis

另請參閱

TRANSACTION_NOTIFICATION

TmEnableCallbacks

使用 Nt 和 Zw 版本的原生系統服務例程

ZwCreateEnlistment

ZwCreateResourceManager

ZwOpenResourceManager