Método IPortWavePci::Notify (portcls.h)

Artigo
02/29/2024

O Notify método notifica o driver de porta de que ocorreu uma interrupção indicando o progresso do ponteiro DMA.

Sintaxe

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

Parâmetros

[in] ServiceGroup

Um ponteiro para o objeto IServiceGroup do driver de miniport.

Retornar valor

Nenhum

Comentários

Alguns drivers de miniporta chamam esse método de um ISR em resposta a uma interrupção de hardware depois de limpar a origem da interrupção. Outros drivers chamam esse método de um DPC de temporizador agendado para execução em intervalos regulares. Como regra geral, somente os drivers que gerenciam um único fluxo de renderização do KMixer devem depender de interrupções de hardware. Os drivers que dão suporte à aceleração de hardware directSound devem desativar interrupções de hardware e usar DPCs de temporizador. Para obter mais informações, consulte IPortWavePciStream::GetMapping.

Embora o driver de miniporta seja livre para escolher sua própria técnica para determinar quando chamar esse método, esse método deve ser chamado com frequência suficiente para permitir que o driver de porta dispare eventos de posição e relógio pendentes em intervalos regulares. No entanto, o tempo para esse método não é tão crítico quanto para o método IPortWaveCyclic::Notify .

Quando um driver de adaptador instala um ISR, ele envia um parâmetro ServiceContext junto com o ponto de entrada do ISR (para obter detalhes, consulte Fornecendo informações de contexto do ISR). Quando a interrupção ocorre, o sistema operacional chama o ISR e passa ServiceContext como um parâmetro de chamada para o ISR. Embora o significado do parâmetro ServiceContext seja conhecido apenas pelo desenvolvedor do driver, ele normalmente é um ponteiro para o objeto miniport. O ISR usa esse ponteiro para acessar informações sobre o objeto miniport.

O parâmetro ServiceGroup segue as convenções de contagem de referência para objetos COM.