Método IKsControl::KsEvent (ksproxy.h)

Artículo
08/07/2023

El método KsEvent habilita o deshabilita un evento, junto con cualquier otra operación de soporte técnico definida disponible en un conjunto de eventos.

Sintaxis

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

Parámetros

[in, optional] Event

Puntero a una estructura KSEVENT que describe un evento para permitir que el evento y NULL deshabiliten el evento.

[in] EventLength

Tamaño, en bytes, del búfer en Evento cuando el evento está habilitado y cero cuando el evento está deshabilitado.

[in, out] EventData

Puntero a una estructura KSEVENTDATA que contiene datos para el evento y el espacio de búfer que recibe los datos del evento.

[in] DataLength

Tamaño, en bytes, del búfer en EventData.

[in, out] BytesReturned

Puntero a una variable que recibe el tamaño, en bytes, de los datos que KsEvent almacena en el búfer en EventData.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error. Si la llamada se realiza correctamente, el evento se encuentra en la lista de eventos del controlador.

Comentarios

Para deshabilitar un evento, establezca Event en NULL, EventLength en cero y EventData en el puntero a la estructura KSEVENTDATA que se usó anteriormente para habilitar el evento.

El parámetro EventData de IKsControl::KsEvent contiene un identificador en EventHandle.Event. Puede esperar a que el identificador esté disponible y recibir notificaciones cuando el minidriver llama a KsXxxGenerateEvents o StreamClassStreamNotification.