Funzione IoSetCancelRoutine (wdm.h)

  • Articolo

La routine IoSetCancelRoutine configura una routine Cancel fornita dal driver da chiamare se viene annullata una determinata IRP.

Sintassi

PDRIVER_CANCEL IoSetCancelRoutine(
  [in] PIRP           Irp,
  [in] PDRIVER_CANCEL CancelRoutine
);

Parametri

[in] Irp

Puntatore all'IRP inserito o rimosso da uno stato annullabile.

[in] CancelRoutine

Specifica il punto di ingresso della routine Cancel fornita dal chiamante da chiamare se l'IRP specificato viene annullato o è NULL se l'IRP specificato viene rimosso dallo stato annullabile. Questa routine viene dichiarata come segue:

VOID
(*PDRIVER_CANCEL)(
    IN PDEVICE_OBJECT DeviceObject,
    IN PIRP Irp
    );

Valore restituito

IoSetCancelRoutine restituisce il valore precedente di Irp-CancelRoutine>. Se non è stata impostata alcuna routine Cancel in precedenza o se l'annullamento di IRP è già in corso, IoSetCancelRoutine restituisce NULL.

Commenti

Questa routine può disabilitare la routine Cancel attualmente impostata in un'istanza di IRP.

Un driver deve contenere il blocco spin spin del sistema quando si chiama questa routine se il driver usa la coda del dispositivo fornita da gestione I/O nell'oggetto dispositivo. Il driver viene eseguito in IRQL = DISPATCH_LEVEL dopo aver chiamato IoAcquireCancelSpinLock finché non rilascia il blocco spin annulla con IoReleaseCancelSpinLock.

Se il driver gestisce le proprie code di IRP, il driver non deve contenere il blocco di rotazione annulla quando si chiama questa routine. IoSetCancelRoutine usa un intrinseco scambio interlocked per impostare l'indirizzo della routine Cancel come operazione atomica. L'utilizzo ridotto del blocco di spin spin annulla può migliorare le prestazioni del driver e le prestazioni complessive del sistema.

Le routine Di annullamento driver vengono chiamate in IRQL = DISPATCH_LEVEL con il blocco di rotazione annulla mantenuto. La routine Annulla deve rilasciare il blocco di rotazione annulla prima di restituire il controllo.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL DISPATCH_LEVEL (vedere la sezione Osservazioni)
Regole di conformità DDI IrpCancelField(wdm), StartIoCancel(wdm)

Vedi anche

IoAcquireCancelSpinLock

IoReleaseCancelSpinLock