Metodo IKsControl::KsEvent (ksproxy.h)

Articolo
08/07/2023

Il metodo KsEvent abilita o disabilita un evento, insieme a qualsiasi altra operazione di supporto definita disponibile in un set di eventi.

Sintassi

HRESULT KsEvent(
  [in, optional] PKSEVENT Event,
  [in]           ULONG    EventLength,
  [in, out]      LPVOID   EventData,
  [in]           ULONG    DataLength,
  [in, out]      ULONG    *BytesReturned
);

Parametri

[in, optional] Event

Puntatore a una struttura KSEVENT che descrive un evento per abilitare l'evento e NULL per disabilitare l'evento.

[in] EventLength

Dimensioni, in byte, del buffer in Evento quando l'evento è abilitato e zero quando l'evento è disabilitato.

[in, out] EventData

Puntatore a una struttura KSEVENTDATA che contiene dati per l'evento e lo spazio buffer che riceve i dati per l'evento.

[in] DataLength

Dimensioni, in byte, del buffer in EventData.

[in, out] BytesReturned

Puntatore a una variabile che riceve le dimensioni, in byte, dei dati archiviati da KsEvent nel buffer in EventData.

Valore restituito

Restituisce NOERROR se ha esito positivo; in caso contrario, restituisce un codice di errore. Se la chiamata ha esito positivo, l'evento si trova nell'elenco degli eventi del driver.

Commenti

Per disabilitare un evento, impostare Event su NULL, EventLength su zero e EventData sul puntatore alla struttura KSEVENTDATA usata in precedenza per abilitare l'evento.

Il parametro EventData di IKsControl::KsEvent contiene un handle in EventHandle.Event. È possibile attendere che l'handle diventi disponibile e ottenere notifiche quando il minidriver chiama KsXxxGenerateEvents o StreamClassStreamNotification.