共用方式為


設定Device-Specific參數

預期大部分遠端 NDIS 裝置在不需要在主機上設定參數的情況下運作良好。 不過,在某些情況下,適當的網路作業需要主機上的一些設定。 如果裝置支援可設定的參數,則它應該在支援的 OID 清單中包含下列選用的 OID,以回應 查詢OID_GEN_SUPPORTED_LIST

#define OID_GEN_RNDIS_CONFIG_PARAMETER 0x0001021B

如果裝置支援 OID_GEN_RNDIS_CONFIG_PARAMETER OID,主機會在裝置從未初始化的狀態進入遠端 NDIS 初始化的狀態之後,使用它來設定裝置特定的參數。 主機會將零個或多個REMOTE_NDIS_SET_MSGs傳送至裝置,OID_GEN_RNDIS_CONFIG_PARAMETER做為要設定的 OID 值。 每個這類 REMOTE_NDIS_SET_MSG 都會對應到主機上設定的一個裝置特定參數。

與每個這類REMOTE_NDIS_SET_MSG相關聯的InformationBuffer具有下列格式。 請注意,Offset 值相對於資訊緩衝區的開頭。

Offset 大小 欄位 描述

0

4

ParameterNameOffset

指定代表參數名稱的 Unicode 字元字串所在的 ParameterNameOffset 欄位開頭的位元組位移。 字串不包含 Null 結束字元。

4

4

ParameterNameLength

指定參數名稱字串的位元組長度。

8

4

ParameterType

指定參數值的資料類型。 這是下列其中一項:0 - 數值;2 - 字串值。

12

4

ParameterValueOffset

指定參數值所在的 ParameterNameOffset 欄位開頭的位元組位移。

16

4

ParameterValueLength

指定參數值的位元組長度。

裝置會在套用參數值之後,傳送 REMOTE_NDIS_SET_CMPLT 來回應每個 REMOTE_NDIS_SET_MSG。 如果參數設定可接受,它會傳迴響應中RNDIS_STATUS_SUCCESS的狀態。 如果無法接受參數設定,且裝置無法套用此參數的實用預設值,則裝置會傳回適當的錯誤狀態值, (請參閱狀態值) 一節。 如果傳回錯誤狀態,主機將會起始裝置的停止程式。

裝置特定參數預期會在 Windows 登錄中設定。 定義參數值的機碼通常會在裝置安裝期間于登錄中建立。 裝置的 INF 檔案中會指定金鑰、類型資訊、預設值和選擇性有效值範圍的清單。 如需使用 INF 在網路裝置登錄中設定組態參數的詳細資訊,請參閱 Windows 2000 驅動程式開發工具組 (DDK) 。