Função VideoPortCreateEvent (video.h)

Artigo
02/07/2025

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 do 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:

Bandeira	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

No momento, é 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.

Valor de retorno

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

Observações

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 transições de espera para pronto, em espera ou em execução) e o evento é automaticamente redefinido 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
de cliente com suporte mínimo	Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	video.h (inclua Video.h)
biblioteca	Videoprt.lib
de DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Consulte também

VideoPortDeleteEvent

Compartilhar via