Поделиться через


Интерфейс IPinCount (portcls.h)

Интерфейс IPinCount предоставляет драйверу мини-порта средства для динамического отслеживания количества контактов и управления ими по мере создания и закрытия экземпляров контактов. Этот интерфейс реализован в драйвере мини-порта. Чтобы определить, поддерживает ли драйвер мини-порта этот интерфейс, драйвер порта вызывает метод QueryInterface объекта мини-порта с IID_IPinCount REFIID. IPinCount наследуется от интерфейса IUnknown .

Следующие драйверы портов будут использовать интерфейс драйвера IPinCount мини-порта, если драйвер мини-порта реализует его: WaveCyclic, WavePci, MIDI, DMus и Топология.

IPinCount — это необязательный интерфейс, который может поддерживать драйвер мини-порта, если ему нужно выполнить одно или оба из следующих действий:

  • Будьте явным образом уведомлены об изменениях количества контактов потоковой передачи ядра.
  • Динамическое изменение количества контактов.
В случае волнового звукового устройства, например, потоки с разными атрибутами (3D, стерео/моно и т. д.) также могут иметь разные "весовые коэффициенты" с точки зрения объема потребляемых ими аппаратных ресурсов.

При открытии "тяжеловесного" потока драйверу мини-порта может потребоваться уменьшать количество доступных контактов на два, а не на один, чтобы точнее указать количество контактов, которые можно создать с оставшимися ресурсами.

Процесс разворачивается при закрытии "тяжеловесного" потока. Число доступных контактов может увеличиться более чем на один, чтобы отразить тот факт, что из недавно освобожденных ресурсов можно создать два или более "облегченных" потоков.

Если драйвер мини-порта не поддерживает IPinCount интерфейс, драйвер порта использует статически инициализированные числа контактов в массиве PCPIN_DESCRIPTOR фильтра.

Интерфейс IPinCount предоставляет один метод. Драйвер порта, привязанный к драйверу мини-порта, вызывает этот метод в ответ на запрос числа контактов.

Наследование

Интерфейс IPinCount наследуется от интерфейса IUnknown.

Методы

Интерфейс IPinCount содержит следующие методы.

 
IPinCount::P inCount

Метод PinCount запрашивает у драйвера мини-порта количество закрепления.

Требования

Требование Значение
Целевая платформа Windows
Header portcls.h