Função SerCx2CompleteWait (sercx.h)

Artigo
03/01/2024

O método SerCx2CompleteWait notifica a versão 2 da extensão de estrutura serial (SerCx2) de que ocorreu um evento na máscara de espera atual.

Sintaxe

void SerCx2CompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

Parâmetros

[in] Device

Um identificador WDFDEVICE para o objeto de dispositivo de estrutura que representa o controlador serial. O driver do controlador serial criou esse objeto em sua função de retorno de chamada EvtDriverDeviceAdd . Para obter mais informações, consulte SerCx2InitializeDevice.

[in] Event

O tipo de evento que está encerrando a operação de espera atual. Esse parâmetro é um valor de máscara de espera. Cada tipo de evento corresponde a um bit específico na máscara de espera. Esse bit é definido para indicar que o evento correspondente ocorreu. Para obter mais informações sobre os tipos de eventos que podem ser especificados por uma máscara de espera, consulte SERIAL_EV_XXX.

Retornar valor

Nenhum

Comentários

Quando o SerCx2 recebe uma solicitação IOCTL_SERIAL_SET_WAIT_MASK de um cliente, o manipulador de solicitação no SerCx2 chama a função de retorno de chamada EvtSerCx2SetWaitMask para notificar o driver do controlador serial de que a máscara de espera foi alterada.

Quando ocorre um evento na nova máscara de espera, o driver chama SerCx2CompleteWait para notificar o SerCx2 do evento. Se uma solicitação IOCTL_SERIAL_WAIT_ON_MASK enviada anteriormente estiver pendente no SerCx2 no momento da chamada SerCx2CompleteWait , o SerCx2 concluirá essa solicitação com uma máscara de espera de saída que indica qual evento ocorreu. Caso contrário, o SerCx2 armazenará o evento em seu histórico de eventos interno na antecipação de uma solicitação de IOCTL_SERIAL_WAIT_ON_MASK futura.