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 |