PCPIN_DESCRIPTOR結構（portcls.h）

發行項
02/07/2025

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的結構。針腳處理站可以有零介面和零媒體。所有情況下都會忽略介面清單。標準媒體清單預設為僅包含裝置 I/O 的清單（KSMEDIUM_STANDARD_DEVIO）。

言論

此結構可用來描述迷你埠驅動程序實作的每個針腳處理站。驅動程式 PCFILTER_DESCRIPTOR 結構包含 PCPIN_DESCRIPTOR 結構的數位指標。陣列中的元素數目等於篩選中的針腳處理站數目。

MaxGlobalInstanceCount、MaxFilterInstanceCount，以及 MinFilterInstanceCount 成員是描述針腳資源限制和功能需求的最大值和最小計數。自動初始化 PCPIN_DESCRIPTOR 陣列只能呈現可用針腳資源的靜態估計值。 IPinCount：:P inCount 方法會提供方法，讓驅動程式在配置和釋放針腳時動態修改其可用針腳資源清單。

MaxGlobalInstanceCount 值類似於：

PinCount 方法的 GlobalPossible 呼叫參數。
KSPROPERTY_PIN_GLOBALCINSTANCES 屬性值（KSPIN_CINSTANCES 結構的 PossibleCount 成員）。

MaxFilterInstanceCount 值類似於：

PinCount 方法的 FilterPossible 呼叫參數。
KSPROPERTY_PIN_CINSTANCES 屬性值（KSPIN_CINSTANCES 結構的 PossibleCount 成員）。

MinFilterInstanceCount 值類似於：

PinCount 方法的 FilterNecessary 呼叫參數。
KSPROPERTY_PIN_NECESSARYINSTANCES 屬性值。

在描述網橋接點時（請參閱 Audio Filter Graphs），請設定 MaxGlobalInstanceCount、MaxFilterInstanceCount，並將 MinFilterInstanceCount設為零，並將 automationTable 設定為 NULL。

如需示範如何使用 PCPIN_DESCRIPTOR 結構的簡單程式代碼範例，請參閱公開篩選拓撲。

如需詳細資訊，請參閱 Pin Factory。