Interfaz IPinCount (portcls.h)
La interfaz IPinCount 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 las patillas. Esta interfaz se implementa en el controlador de miniport. Para determinar si un controlador de miniporte 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 IPinCount de un controlador de miniporte si el controlador de miniporte lo implementa: WaveCíclico, WavePci, MIDI, DMus y Topología.
IPinCount es una interfaz opcional que un controlador de miniporte puede admitir si necesita hacerlo o ambos de los siguientes:
- 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.
Al abrir una secuencia de "peso pesado", es posible que el controlador de miniporte necesite reducir 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 miniporte no admite la interfaz IPinCount, el controlador de puerto usa los recuentos de patillas inicializadas estáticamente en la matriz de PCPIN_DESCRIPTOR del filtro.
La interfaz IPinCount proporciona un único método. El controlador de puerto enlazado al controlador de miniporta llama a este método en respuesta a una consulta de recuento 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 miniport para su recuento de patillas. |
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| encabezado de | portcls.h |