Funzione KsEnableEvent (ks.h)

Articolo
02/26/2024

La funzione KsEnableEvent abilita gli eventi richiesti tramite IOCTL_KS_ENABLE_EVENT. Risponde a tutti gli identificatori di evento definiti dai set. Questa funzione può essere chiamata solo in PASSIVE_LEVEL.

Sintassi

KSDDKAPI NTSTATUS KsEnableEvent(
  [in]           PIRP              Irp,
  [in]           ULONG             EventSetsCount,
  [in]           const KSEVENT_SET *EventSet,
  [in, out]      PLIST_ENTRY       EventsList,
  [in, optional] KSEVENTS_LOCKTYPE EventsFlags,
  [in, optional] PVOID             EventsLock
);

Parametri

[in] Irp

Specifica l'IRP con la richiesta di abilitazione gestita. L'oggetto file associato all'IRP viene archiviato con l'evento per un confronto successivo durante la disabilitazione dell'evento.

[in] EventSetsCount

Indica il numero di strutture del set di eventi passate.

[in] EventSet

Specifica un puntatore all'elenco di informazioni sul set di eventi.

[in, out] EventsList

Se il KSEVENT_SET dell'evento di abilitazione. AddHandler per il set di eventi è NULL, deve puntare all'elemento head dell'elenco di KSEVENT_ENTRY elementi in cui deve essere aggiunto l'evento. Questa funzione presuppone un singolo elenco per almeno un subset di eventi.

[in, optional] EventsFlags

Specifica KSEVENTS_LOCKTYPE flag che specificano il tipo di blocco di esclusione da usare per accedere all'elenco eventi, se presente. Se non viene impostato alcun flag, non viene eseguito alcun blocco. Se è già specificato un gestore, questo parametro viene ignorato.

[in, optional] EventsLock

Se il KSEVENT_SET. AddHandler per il set di eventi contenente l'evento abilitato è NULL, quindi viene usato per sincronizzare l'accesso all'elenco. Questo valore può essere NULL se non viene impostato alcun flag in EventsFlags.

Valore restituito

La funzione KsEnableEvent restituisce STATUS_SUCCESS se ha esito positivo o un errore specifico dell'evento abilitato se non è riuscito. La funzione imposta sempre il IO_STATUS_BLOCK. Campo informazioni del PIRP. Elemento IoStatus all'interno dell'oggetto IRP su zero. Non imposta la IO_STATUS_BLOCK. Campo stato, né completa l'IRP.

Commenti

I minidriver non chiamano KsEnableEvent. Solo un driver KS puro o un driver di classe deve chiamare questa routine.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib

Vedi anche

KsDisableEvent

Condividi tramite