Função KsPinGenerateEvents (ks.h)

A função KsPinGenerateEvents gera eventos de um tipo indicado que estão presentes na lista de eventos do Pin.

Sintaxe

void KsPinGenerateEvents(
  [in]           PKSPIN                     Pin,
  [in, optional] const GUID                 *EventSet,
  [in]           ULONG                      EventId,
  [in]           ULONG                      DataSize,
  [in, optional] PVOID                      Data,
  [in, optional] PFNKSGENERATEEVENTCALLBACK CallBack,
  [in, optional] PVOID                      CallBackContext
);

Parâmetros

[in] Pin

Um ponteiro para a estrutura KSPIN na qual gerar eventos.

[in, optional] EventSet

Um ponteiro para o GUID do conjunto de eventos a ser correspondido para determinar quais eventos gerar. Se esse parâmetro for NULL, definir GUID não será levado em conta para determinar eventos correspondentes.

[in] EventId

A ID do evento a ser correspondida para determinar quais eventos gerar.

[in] DataSize

O tamanho em bytes dos dados com os quais gerar o evento de dados.

[in, optional] Data

Um ponteiro para um buffer de dados. Especifique se está gerando um evento de dados.

[in, optional] CallBack

Um ponteiro para uma função especificada pelo chamador que é chamada para determinar se um determinado evento deve ser gerado. Se FOR NULL, nenhuma verificação de retorno de chamada será executada para determinar se um evento deve ser gerado (somente *EventSet *e EventId são usados). Protótipo da seguinte maneira:

BOOLEAN CallBack
(IN PVOID Context,
    IN PKSEVENT_ENTRY EventEntry);

KsPinGenerateEvents passa o parâmetro CallBackContext inalterado como o parâmetro Context para o retorno de chamada. A função de retorno de chamada retornará TRUE se EventEntry deve ser gerado. Caso contrário, retornará FALSE.

[in, optional] CallBackContext

Um ponteiro para um contexto especificado pelo chamador que é passado para a função de retorno de chamada CallBack.

Retornar valor

Nenhum

Comentários

Ao chamar essa função, um minidriver deve colocar Data e CallBackContext em um segmento de dados bloqueado e não pageable. O CallBack é feito em DISPATCH_LEVEL. A função de retorno de chamada deve estar em um segmento bloqueado e deve estar preparada para ser executada em IRQL = DISPATCH_LEVEL. Observe que há um problema adicional somente no DX8: EventSet deve estar em um segmento de dados bloqueado.

Essa é uma chamada de função embutida para KsGenerateEvents, que executa o typecasting necessário. Os minidrivers geralmente devem chamar essa versão em vez de chamar diretamente KsGenerateEvents.

Um evento será gerado se as três condições a seguir se mantiverem:

• O evento está presente na *lista de eventos de *Pin e *EventId *corresponde à ID do evento.

• EventSet corresponde ao GUID definido do evento ou é NULL.

• *CallBack *é NULL ou autoriza a correspondência.

Para obter mais informações, consulte Tratamento de eventos em eventos AVStream e KS.

Requisitos

Confira também

KSEVENT_ENTRY

KsAddEvent

KsFilterGenerateEvents

KsGenerateEvents