「TCP/IP 轉換器」建構可讓您使用從特定 MIB (SNMP 管理資訊庫) 物件擷取資料的查詢來延伸 bidi 通訊 綱目,然後將資料轉換成字串值,該值是根據轉換元素中指定的值組清單。 轉換器建構定義在 Tcpbidi.xsd 中。
| 屬性 | 說明 |
|---|---|
| 裝置索引 | (選用)布林值,當 TRUE 時,表示相關聯的演算法必須在指定的 OID 中包含裝置索引;當此屬性為 FALSE 時,尾端零會附加至 OID。 預設值 FALSE。 如需詳細資訊,請參閱下表後面的附註。 |
| drvPrinterEvent | (選擇性)布爾值,指出埠監視器是否傳送通知給驅動程式。 TRUE 值表示埠監視器會將通知傳送給驅動程式;FALSE 表示埠監視器不會傳送通知給驅動程式。 |
| 名字 | 代表結構描述元素名稱的字串值。 |
| 對象識別碼 | 表示 MIB 物件位址的字串值,做為物件識別碼 (OID)。 |
| 刷新間隔 | (選用)輪詢間隔的整數值,以秒為單位。 預設值為 600 秒。 |
| useFirstIndex | (選用)布林值,可設定為讀取 MIB 表格中的第一個項目。 只有在 Converter 建構位於 Property 實例內時,才會使用此屬性。 |
備註
支援 SNMP 通訊協定的網路裝置可以是不同子裝置的主機,例如處理器、網路、印表機和磁碟儲存體。 在網路印表機中實作的 MIB 表格包含以裝置索引為索引的項目。 若要從 MIB 資料表擷取資料(例如輸入 bin 的名稱),查詢必須具有能正確識別子設備的子裝置索引。 標準 TCP/IP 埠監視器允許透過埠配置 UI 手動配置裝置索引。 deviceIndex 屬性設定為 TRUE 的 bidi 延伸模組會產生 OID,其中包含從埠組態 UI 取得的適當裝置索引。 此外,如果 Converter 建構包含在 Property 實例中,且 deviceIndex 屬性遺漏或設定為 FALSE,則 OID 會在其結尾附加零索引。
轉換常式支援下列 MIB 資料類型:
整數
Integer32
量測計32
Counter32
TimeTicks
無符號32位元
Counter64
不透明
八位元組字串
物件標識碼
轉換元件
每個轉換器建構都會包含一或多個轉換元素,以定義從 MIB 元素讀取的值對應至 Bidi 架構值。
| 屬性 | 說明 |
|---|---|
| mib值 | (選用)字串值,代表可從 MIB 讀取的一個可能資料值。 |
| bidi值 | (選用)字串值,代表資料符合此轉換元素的 mibValue 屬性時傳回的 bidi 值。 |
程式碼範例
下列程式碼範例會藉由新增屬性和轉換器建構來擴充 bidi 通訊結構描述。
<Property name="Printer">
<Property name="Layout">
<Property name="InputBins">
<IndexedProperty name="Bin">
<Converter name="BinType" oid="1.3.6.1.2.1.43.8.2.1.2" deviceIndex="true">
<Conversion mibValue="2" bidiValue="Unknown"/>
<Conversion mibValue="3" bidiValue="SheetFeedAutoRemovableTray"/>
<Conversion mibValue="4" bidiValue="SheetFeedAutoNonRemovableTray"/>
<Conversion mibValue="5" bidiValue="SheetFeedManual"/>
<Conversion mibValue="6" bidiValue="ContinuousRoll"/>
<Conversion mibValue="7" bidiValue="ContinuousFanFold"/>
</Converter>
</IndexedProperty>
</Property>
<Property name="Orientation">
<Converter name="CurrentValue" oid="1.3.6.1.2.1.43.15.1.1.7" deviceIndex="true" useFirstIndex="true">
<Conversion mibValue="3" bidiValue="Portrait"/>
<Conversion mibValue="4" bidiValue="Landscape"/>
</Converter>
</Property>
</Property>
<Property name="Custom">
<Property name="HostResourceMIB">
<Converter name="InterfaceName" oid="1.3.6.1.2.1.2.1">
<Conversion mibValue="1" bidiValue="InterfaceOne"/>
<Conversion mibValue="2" bidiValue="InterfaceTwo"/>
</Converter>
</Property>
</Property
</Property>
上述範例會產生下列查詢。
\Printer.Layout.InputBins.Bin###:BinType
\Printer.Layout.Orientation:CurrentValue
\Printer.Custom.HostResourceMIB:InterfaceName
BinType 的 Converter 結構位於 IndexedProperty 實例中,因此,目前的 MIB 表格資料列條目會自動附加至 OID。
因為 的 CurrentValue 轉換器建構包含在 Property 實例中,而且 useFirstIndex 屬性設定為 “true”,所以尾端 “1” 會自動附加至 OID。
InterfaceName的Converter建構包含在一個Property實例中,因此後綴的零會自動附加至OID。