Partilhar via


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

O método Notify notifica o driver de porta de que ocorreu uma interrupção que indica 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.

Valor de retorno

Nenhum

Observações

Alguns drivers de miniporto chamam esse método de um ISR em resposta a uma interrupção de hardware depois de terem limpado a origem da interrupção. Outros drivers chamam esse método de um DPC de temporizador agendado para ser executado 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 do DirectSound devem desativar interrupções de hardware e usar DPCs de temporizador. Para obter mais informações, consulte IPortWavePciStream::GetMapping.

Embora o driver de miniporte 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 juntamente com o ponto de entrada do ISR (para obter detalhes, consulte Fornecendo informações de contexto 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 de miniporto. 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.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho portcls.h (inclua Portcls.h)
IRQL Qualquer nível

Consulte também

IPortWaveCyclic::Notify

IPortWavePci

IPortWavePciStream::GetMapping

IServiceGroup