Metodo IKsControl::KsEvent (ksproxy.h)

Articolo
02/07/2025

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 di KSEVENT che descrive un evento per abilitare l'evento e NULL per disabilitare l'evento.

[in] EventLength

Dimensioni, in byte, del buffer in corrispondenza del Event 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 corrispondenza di EventData.

[in, out] BytesReturned

Puntatore a una variabile che riceve le dimensioni, in byte, dei dati che KsEvent archivia 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.

Osservazioni

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 ricevere notifiche quando il minidriver chiama KsXxxGenerateEvents o StreamClassStreamNotification.