PCPIN_DESCRIPTOR結構 (portcls.h)

發行項
02/26/2024

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 值類似於：