Compartilhar via


Função VideoPortCreateEvent (video.h)

A função VideoPortCreateEvent cria um objeto de evento.

Sintaxe

VIDEOPORT_API VP_STATUS VideoPortCreateEvent(
  [in]  IN PVOID   HwDeviceExtension,
  [in]  IN ULONG   EventFlag,
  [in]  IN PVOID   Unused,
  [out] OUT PEVENT *ppEvent
);

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão de dispositivo do driver de miniport.

[in] EventFlag

Especifica o tipo de evento e o estado inicial do evento. Isso pode ser uma combinação ORed dos seguintes sinalizadores:

Sinalizador Significado
INITIAL_EVENT_SIGNALED Defina esse sinalizador para indicar o estado sinalizado para o objeto de evento. Caso contrário, o estado inicial do evento não será atribuído.
NOTIFICATION_EVENT Defina esse sinalizador para criar um evento de notificação. Se esse sinalizador não estiver definido, um evento de sincronização será criado.

[in] Unused

Atualmente, é ignorado pelo driver de porta de vídeo e deve ser definido como NULL.

[out] ppEvent

Ponteiro para o local de memória no qual um ponteiro para o objeto de evento será retornado.

Retornar valor

VideoPortCreateEvent retornará NO_ERROR se o objeto de evento for criado com êxito.

Comentários

Quando um evento de sincronização é definido como o estado sinalizado, um único thread que estava aguardando o estado sinalizado é liberado (seu estado de expedição faz a transição de aguardando para pronto, em espera ou em execução) e o evento é redefinido automaticamente para o estado não atribuído.

Quando um evento de notificação é definido como o estado sinalizado, todos os threads que estavam aguardando o estado sinalizado são liberados e o evento permanece no estado sinalizado até que seja redefinido explicitamente para o estado não atribuído.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho video.h (incluir Video.h)
Biblioteca Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Confira também

VideoPortDeleteEvent