PMINIPORT_SYNCHRONIZE_ROUTINE função de retorno de chamada (video.h)

Artigo
02/27/2024

HwVidSynchronizeExecutionCallback é uma função de driver de miniporto opcional, passada em chamadas para VideoPortSynchronizeExecution.

Sintaxe

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

Parâmetros

Context

Ponteiro para dados de contexto passados para a rotina de retorno de chamada por meio de VideoPortSynchronizeExecution. Normalmente, esse é um ponteiro para a extensão do dispositivo ou um deslocamento dentro da extensão do dispositivo.

Retornar valor

Se a operação for bem-sucedida, HwVidSynchronizeExecutionCallback retornará TRUE.

Comentários

Um driver de miniporto com uma ou mais funções que compartilham memória com sua função HwVidInterrupt deve ter uma função HwVidSynchronizeExecutionCallback . Qualquer função que compartilhe memória com HwVidInterrupt deve chamar VideoPortSynchronizeExecution com a função HwVidSynchronizeExecutionCallback para manter a integridade dos dados na área de memória compartilhada. Ou seja, apenas uma das funções HwVidSynchronizeExecutionCallback e HwVidInterrupt pode atualizar o estado na área compartilhada a qualquer momento.

O driver de miniporto de um adaptador que não gera interrupções também pode ter uma função HwVidSynchronizeExecutionCallback a ser passada para VideoPortSynchronizeExecution quando esse driver precisa fazer algum trabalho crítico em uma prioridade de tempo de execução relativamente alta. Por exemplo, os drivers de miniporto compatíveis com VGA com funções SvgaHwIoPortXxx (consulte Funções SVGA) podem ter uma função HwVidSynchronizeExecutionCallback responsável por transferir e/S emitidas pelo aplicativo em buffer de driver e validadas para o adaptador.

HwVidSynchronizeExecutionCallback não deve ser tornado paginável.