Interfaz IPinCount (portcls.h)

La IPinCount interfaz proporciona un medio para que el controlador de miniporte supervise y manipule sus recuentos de patillas dinámicamente a medida que se crean instancias y se cierran. Esta interfaz se implementa en el controlador de minipuerto. Para determinar si un controlador de minipuerto admite esta interfaz, el controlador de puerto llama al método QueryInterface del objeto de miniporte con REFIID IID_IPinCount. IPinCount hereda de la interfaz IUnknown .

Los siguientes controladores de puerto usarán la interfaz del IPinCount controlador de minipuerto si el controlador de minipuerto lo implementa: WaveCíclico, WavePci, MIDI, DMus y Topología.

IPinCount es una interfaz opcional que un controlador de minipuerto puede admitir si necesita hacer una de las siguientes acciones o ambas:

  • Recibir una notificación explícita de los cambios en los recuentos de patillas de streaming del kernel.
  • Cambie dinámicamente sus recuentos de patillas.
En el caso de un dispositivo de audio de onda, por ejemplo, las secuencias con diferentes atributos (3D, estéreo/mono, etc.) también pueden tener diferentes "pesos" en términos de la cantidad de recursos de hardware que consumen.

Al abrir una secuencia de "peso pesado", es posible que el controlador de miniporte tenga que disminuir el número de patillas disponibles en dos en lugar de uno para indicar con más precisión el número de patillas que se pueden crear con los recursos restantes.

El proceso se invierte cuando se cierra una secuencia de "peso pesado". El número de patillas disponibles puede aumentar en más de uno para reflejar el hecho de que se pueden crear dos o más secuencias "ligeras" a partir de los recursos recién liberados.

Si un controlador de minipuerto no admite la IPinCount interfaz , el controlador de puerto usa los recuentos de patillas inicializados estáticamente en la matriz de PCPIN_DESCRIPTOR del filtro.

La IPinCount interfaz proporciona un único método. El controlador de puerto enlazado al controlador de minipuerto llama a este método en respuesta a una consulta de número de patillas.

Herencia

La interfaz IPinCount hereda de la interfaz IUnknown.

Métodos

La interfaz IPinCount tiene estos métodos.

 
IPinCount::P inCount

El método PinCount consulta el controlador de miniporte para su recuento de patillas.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado portcls.h