структура PCPIN_DESCRIPTOR (portcls.h)

Структура PCPIN_DESCRIPTOR описывает фабрику закреплений.

Синтаксис

typedef struct {
  ULONG                    MaxGlobalInstanceCount;
  ULONG                    MaxFilterInstanceCount;
  ULONG                    MinFilterInstanceCount;
  const PCAUTOMATION_TABLE *AutomationTable;
  KSPIN_DESCRIPTOR         KsPinDescriptor;
} PCPIN_DESCRIPTOR, *PPCPIN_DESCRIPTOR;

Члены

MaxGlobalInstanceCount

Указывает глобальное максимальное число случаев создания экземпляра этого типа пин-кода. Глобальное максимальное число экземпляров закреплений, которые драйвер адаптера может поддерживать во всех экземплярах фильтра. Число может быть равно нулю, чтобы указать, что пин-код не может быть создан. Значение ULONG(-1) указывает, что пин-код можно создать в любом количестве раз. Любое другое значение указывает определенное количество раз, когда можно создать экземпляр пин-кода.

MaxFilterInstanceCount

Указывает максимальное число раз, когда пин-код можно создать в одном экземпляре фильтра. Число может быть равно нулю, чтобы указать, что пин-код не может быть создан. Значение ULONG(-1) указывает, что пин-код можно создать в любом количестве раз. Любое другое значение указывает определенное количество раз, когда можно создать экземпляр пин-кода.

MinFilterInstanceCount

Указывает минимальное количество раз, когда пин-код должен быть создан в экземпляре фильтра. Этот элемент является определенной нижней границой по количеству экземпляров закреплений, которые должны существовать, чтобы фильтр мог функционировать.

AutomationTable

Указатель на таблицу автоматизации. Этот элемент является указателем на структуру типа PCAUTOMATION_TABLE. Указатель может иметь значение NULL , чтобы указать, что автоматизация не поддерживается. Таблица автоматизации задает обработчики свойств и событий, принадлежащих экземпляру пин-кода.

KsPinDescriptor

Описывает фабрику закреплений. Этот элемент представляет собой структуру типа KSPIN_DESCRIPTOR. Фабрика контактов может иметь нулевые интерфейсы и ноль средних сред. Список интерфейсов игнорируется во всех случаях. Стандартный средний список по умолчанию будет содержать список, содержащий только устройства ввода-вывода (KSMEDIUM_STANDARD_DEVIO).

Замечания

Эта структура используется для описания каждого из заводов закреплений, которые реализует мини-драйвер. Структура драйвера PCFILTER_DESCRIPTOR содержит указатель на массив PCPIN_DESCRIPTOR структур. Число элементов в массиве равно числу заводов закреплений в фильтре.

Члены MaxGlobalInstanceCount, MaxFilterInstanceCount и MinFilterInstanceCount являются максимальными и минимальными числами, описывающими ограничения ресурсов и функциональные требования пин-кода. Автоматически инициализированный массив PCPIN_DESCRIPTOR может представлять только статическую оценку доступных ресурсов закреплений. Метод IPinCount::P inCount предоставляет средства для изменения списка доступных ресурсов пин-кода динамически, так как закрепление выделяется и освобождается.

Значение MaxGlobalInstanceCount аналогично значению:

• Параметр вызова GlobalPossible метода PinCount.
• Значение свойства KSPROPERTY_PIN_GLOBALCINSTANCES (член возможногоcount структуры KSPIN_CINSTANCES).

• Параметр вызова FilterPossible метода PinCount.
• Значение свойства KSPROPERTY_PIN_CINSTANCES (член возможногоcount структуры KSPIN_CINSTANCES).

• Параметр вызова FilterNecessary метода PinCount.
• Значение свойства KSPROPERTY_PIN_NECESSARYINSTANCES .

Простой пример кода, показывающий, как используется структура PCPIN_DESCRIPTOR , см. в разделе "Экспонирование топологии фильтра".

Дополнительные сведения см. в разделе "Закрепление фабрик".

Требования

См. также

IPinCount::P inCount

KSPIN_DESCRIPTOR

KSPROPERTY_PIN_CINSTANCES

KSPROPERTY_PIN_GLOBALCINSTANCES

KSPROPERTY_PIN_NECESSARYINSTANCES

PCAUTOMATION_TABLE