PTM_RM_NOTIFICATION funzione di callback (wdm.h)
La routine di callback ResourceManagerNotification di Resource Manager riceve e gestisce le notifiche delle transazioni.
Sintassi
PTM_RM_NOTIFICATION PtmRmNotification;
NTSTATUS PtmRmNotification(
[in] PKENLISTMENT EnlistmentObject,
[in] PVOID RMContext,
[in] PVOID TransactionContext,
[in] ULONG TransactionNotification,
[in, out] PLARGE_INTEGER TmVirtualClock,
[in] ULONG ArgumentLength,
[in] PVOID Argument
)
{...}
Parametri
[in] EnlistmentObject
Puntatore a un oggetto di integrazione. La routine di callback ResourceManagerNotification riceve una notifica per l'integrazione rappresentata da questo oggetto.
[in] RMContext
Valore specificato in precedenza per il parametro RMKey della routine TmEnableCallbacks .
[in] TransactionContext
Valore specificato in precedenza per il parametro EnlistmentKey della routine ZwCreateEnlistment .
[in] TransactionNotification
Uno dei valori TRANSACTION_NOTIFY_XXX definiti in Ktmtypes.h. Questo valore specifica il tipo di notifica della transazione inviata dal KTM al chiamante.
[in, out] TmVirtualClock
Puntatore a una posizione contenente il valore dell'orologio virtuale al momento in cui KTM ha preparato la notifica per il recapito al gestore risorse. Se la routine di callback aumenta questo valore prima che venga restituito, KTM aggiorna l'orologio virtuale al nuovo valore. In genere, i gestori di risorse non modificano il valore dell'orologio virtuale.
[in] ArgumentLength
Lunghezza, in byte, del buffer a cui punta il parametro Argument . Questo parametro è zero se un buffer non è disponibile.
[in] Argument
Puntatore a un buffer contenente argomenti specifici della notifica. Questo parametro è NULL se la notifica che il parametro TransactionNotification specifica non richiede un buffer di argomenti.
Per un elenco di notifiche che includono un buffer di argomenti aggiuntivo, vedere la sezione Osservazioni di TRANSACTION_NOTIFICATION.
Valore restituito
La routine di callback ResourceManagerNotification deve restituire STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS(status) è uguale a TRUE se l'operazione ha esito positivo.
In genere, resource manager restituisce STATUS_SUCCESS se la notifica viene usata in modo sincrono e STATUS_PENDING se la notifica viene usata in modo asincrono, ma può restituire STATUS_PENDING in entrambi i casi. Tuttavia, il gestore risorse può restituire STATUS_PENDING solo per le notifiche a cui risponde chiamando una delle routine TmXxxComplete o ZwXxxComplete .
In altre parole, se il gestore delle risorse deve rispondere a una notifica chiamando una delle routine TmXxxComplete o ZwXxxComplete , può restituire STATUS_PENDING per la notifica e successivamente chiamare la routine TmXxxComplete o ZwXxxComplete appropriata.
Se si verifica un errore, la routine di callback deve restituire un valore di stato per il quale NT_SUCCESS(status) è uguale a FALSE.
Commenti
Per registrare una routine di callback ResourceManagerNotification , il gestore delle risorse deve chiamare TmEnableCallbacks.
Si noti che le routine di callback ResourceManagerNotification ricevono un puntatore, anziché un handle, a un oggetto di integrazione. È possibile passare il puntatore dell'oggetto di integrazione alle routine TmXxx dell'oggetto di integrazione.
Per altre informazioni sulle routine di callback ResourceManagerNotification, vedere Creazione di un Resource Manager.
La routine di callback ResourceManagerNotification viene chiamata in IRQL = PASSIVE_LEVEL e deve restituire in IRQL = PASSIVE_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive del sistema operativo. |
| Piattaforma di destinazione | Desktop |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni) |