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

Artigo
02/26/2024

O método KsEvent habilita ou desabilita um evento, juntamente com quaisquer outras operações de suporte definidas disponíveis em um conjunto de eventos.

Sintaxe

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

Ponteiro para uma estrutura KSEVENT que descreve um evento para habilitar o evento e NULL para desabilitar o evento.

[in] EventLength

Tamanho, em bytes, do buffer em Evento quando o evento estiver habilitado e zero quando o evento estiver desabilitado.

[in, out] EventData

Ponteiro para uma estrutura KSEVENTDATA que contém dados para o evento e o espaço de buffer que recebe dados para o evento.

[in] DataLength

Tamanho, em bytes, do buffer em EventData.

[in, out] BytesReturned

Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados que o KsEvent armazena no buffer em EventData.

Retornar valor

Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro. Se a chamada for bem-sucedida, o evento estará na lista de eventos do driver.

Comentários

Para desabilitar um evento, defina Event como NULL, EventLength como zero e EventData como o ponteiro para a estrutura KSEVENTDATA que foi usada anteriormente para habilitar o evento.

O parâmetro EventData de IKsControl::KsEvent contém um identificador em EventHandle.Event. Você pode aguardar até que o identificador fique disponível e receber notificações quando o minidriver chamar KsXxxGenerateEvents ou StreamClassStreamNotification.