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.
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.
La interfaz IPinCount hereda de la interfaz IUnknown.
La interfaz IPinCount tiene estos métodos.
IPinCount::P inCount El método PinCount consulta el controlador de miniporte para su recuento de patillas. |
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | portcls.h |