struttura EXT_DELETE_PARAMETERS (wdm.h)

Articolo
08/08/2023

La struttura EXT_DELETE_PARAMETERS contiene un set esteso di parametri per la routine ExDeleteTimer .

Sintassi

typedef struct _EXT_DELETE_PARAMETERS {
  ULONG                Version;
  ULONG                Reserved;
  PEXT_DELETE_CALLBACK DeleteCallback;
  PVOID                DeleteContext;
} EXT_DELETE_PARAMETERS, *PEXT_DELETE_PARAMETERS;

Members

Version

Numero di versione di questa struttura EXT_DELETE_PARAMETERS . La routine ExInitializeDeleteTimerParameters imposta questo membro sul numero di versione corretto.

Reserved

Imposta su zero. La routine ExInitializeDeleteTimerParameters imposta questo membro su zero.

DeleteCallback

Puntatore a una routine di callback exTimerDeleteCallback implementata dal driver. Il sistema operativo chiama questa routine quando il timer viene eliminato. Questo parametro è facoltativo e può essere NULL se non è necessaria alcuna routine di callback di eliminazione timer.

La routine ExInitializeDeleteTimerParameters imposta questo membro su NULL. Per altre informazioni, vedere la sezione Osservazioni.

DeleteContext

Valore di contesto per la routine di callback di eliminazione timer. Il sistema operativo passa questo valore come parametro alla routine di callback di eliminazione timer, se è specificato. Questo parametro è in genere un puntatore a una struttura definita dal chiamante che contiene informazioni sul contesto usate dalla routine di callback. Questo parametro è facoltativo e può essere impostato su NULL se non sono necessarie informazioni di contesto.

La routine ExInitializeDeleteTimerParameters imposta questo membro su NULL.

Commenti

Il parametro Parameters della routine ExDeleteTimer è un puntatore a una struttura EXT_DELETE_PARAMETERS . Prima di passare una struttura EXT_DELETE_PARAMETERS a questa routine, chiamare la routine ExInitializeDeleteTimerParameters per inizializzare la struttura.

Il driver può usare una routine di callback ExTimerDeleteCallback per liberare qualsiasi risorsa di archiviazione o altre risorse di sistema che il driver potrebbe aver precedentemente allocato per l'uso con l'oggetto timer che viene eliminato. Ad esempio, il valore di contesto del driver potrebbe puntare a una struttura allocata dal chiamante che deve essere liberata se l'oggetto timer deve essere eliminato. Il sistema operativo chiama la routine ExTimerDeleteCallback solo dopo che l'oggetto timer è stato disabilitato per impedire ulteriori operazioni timer e qualsiasi operazione timer in sospeso sull'oggetto timer viene annullata o completata.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato a partire da Windows 8.1.
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Vedi anche

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback

Condividi tramite