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

Artículo
03/05/2024

El Notify método notifica al controlador de puerto que se ha producido una interrupción que indica el progreso del puntero DMA.

Sintaxis

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

Parámetros

[in] ServiceGroup

Puntero al objeto IServiceGroup del controlador de miniport.

Valor devuelto

None

Observaciones

Algunos controladores de minipuerto llaman a este método desde un ISR en respuesta a una interrupción de hardware después de haber borrado el origen de la interrupción. Otros controladores llaman a este método desde un DPC de temporizador programado para ejecutarse a intervalos regulares. Como regla general, solo los controladores que administran una única secuencia de representación de KMixer deben depender de interrupciones de hardware. Los controladores que admiten la aceleración de hardware de DirectSound deben desactivar las interrupciones de hardware y usar los DPC del temporizador en su lugar. Para obtener más información, vea IPortWavePciStream::GetMapping.

Aunque el controlador de minipuerto es libre de elegir su propia técnica para determinar cuándo llamar a este método, este método debe llamarse con frecuencia suficiente para permitir que el controlador del puerto active eventos de posición pendientes y eventos de reloj a intervalos regulares. El tiempo de este método no es tan crítico como para el método IPortWaveCíclica::Notify , sin embargo.

Cuando un controlador de adaptador instala un ISR, envía un parámetro ServiceContext junto con el punto de entrada de ISR (para obtener más información, consulte Proporcionar información de contexto de ISR). Cuando se produce la interrupción, el sistema operativo llama al ISR y pasa ServiceContext como parámetro de llamada al ISR. Aunque el significado del parámetro ServiceContext solo se conoce para el desarrollador del controlador, normalmente es un puntero al objeto miniport. El ISR usa este puntero para obtener acceso a información sobre el objeto miniport.

El parámetro ServiceGroup sigue las convenciones de recuento de referencias para objetos COM.