TmEnableCallbacks 함수(wdm.h)
TmEnableCallbacks 루틴은 트랜잭션 알림을 받는 콜백 루틴을 사용하도록 설정합니다.
구문
NTSTATUS TmEnableCallbacks(
[in] PKRESOURCEMANAGER ResourceManager,
[in] PTM_RM_NOTIFICATION CallbackRoutine,
[in, optional] PVOID RMKey
);
매개 변수
[in] ResourceManager
리소스 관리자 개체에 대한 포인터입니다. 이 포인터를 가져오려면 구성 요소가 ObReferenceObjectByHandle 을 호출하고 ZwCreateResourceManager 또는 ZwOpenResourceManager 에 대한 이전 호출이 제공한 개체 핸들을 제공해야 합니다.
[in] CallbackRoutine
ResourceManagerNotification 루틴에 대한 포인터입니다.
[in, optional] RMKey
리소스 관리자를 고유하게 식별하는 호출자 정의 컨텍스트 값입니다. 호출자의 ResourceManagerNotification 루틴은 이 값을 입력으로 받습니다.
반환 값
TmEnableCallbacks는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 루틴이 다음 값을 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
CallbackRoutine 포인터는 NULL입니다. |
루틴은 다른 NTSTATUS 값을 반환할 수 있습니다.
설명
리소스 관리자는 TmEnableCallbacks 를 호출하여 ResourceManagerNotification 콜백 루틴을 사용하도록 설정할 수 있습니다. TmEnableCallbacks를 사용하여 비동기 알림을 사용하도록 설정합니다. ZwGetNotificationResourceManager를 사용하여 알림을 동기적으로 가져옵니다.
리소스 관리자는 각 리소스 관리자 개체에 대해 하나의 콜백 루틴을 등록할 수 있습니다.
TmEnableCallbacks 루틴에 대한 자세한 내용은 Resource Manager 만들기를 참조하세요.
Zw Xxx 루틴 대신 KTM의 TmXxx 루틴을 사용하는 경우에 대한 자세한 내용은 TmXxx 루틴 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 운영 체제 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |