Função SerCx2CompleteWait (sercx.h)

Artigo
10/30/2024

O método SerCx2CompleteWait notifica a versão 2 da extensão da 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 da 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.

Valor de retorno

Nenhum

Observações

Quando o SerCx2 recebe uma solicitação IOCTL_SERIAL_SET_WAIT_MASK de um cliente, o manipulador de solicitação no SerCx2 chama o EvtSerCx2SetWaitMask função de retorno de chamada 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 armazena o evento em seu histórico de eventos interno em antecipação a uma solicitação de IOCTL_SERIAL_WAIT_ON_MASK futura.