OID_NIC_SWITCH_PARAMETERS

發行項
06/15/2023

過度配置驅動程式會發出物件識別碼， (OID) 方法要求OID_NIC_SWITCH_PARAMETERS，以取得網路介面卡上指定 NIC 交換器的目前組態參數。 NDIS 會處理迷你埠驅動程式的這些 OID 方法要求。

過度配置驅動程式會發出 OID 集合OID_NIC_SWITCH_PARAMETERS要求，以在網路介面卡上設定指定 NIC 交換器的組態參數。這些 OID 集合要求會發出給網路介面卡 PCI Express (PCIe 的迷你埠驅動程式，) 實體函式 (PF) 。支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的 PF 迷你埠驅動程式需要這些 OID 集合要求。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_NIC_SWITCH_PARAMETERS結構的指標。

過度配置驅動程式會指定 OID 方法的 NIC 參數，或藉由將NDIS_NIC_SWITCH_PARAMETERS結構的SwitchId成員設定為交換器識別碼來設定要求。過度處理驅動程式會透過下列其中一種方式取得交換器識別碼：

從先前的 OID 方法要求 OID_NIC_SWITCH_ENUM_SWITCHES。
從NDIS_BIND_PARAMETERS結構的NicSwitchArray成員。 NDIS 會在ProtocolBindAdapterEx函式的BindParameters參數中傳遞這個結構的指標。
從NDIS_FILTER_ATTACH_PARAMETERS結構的NicSwitchArray成員。 NDIS 會在FilterAttach函式的AttachParameters參數中傳遞這個結構的指標。

注意從Windows Server 2012開始，Windows 僅支援網路介面卡上的預設 NIC 交換器。 NDIS_NIC_SWITCH_PARAMETERS結構的SwitchId成員必須設定為 NDIS_DEFAULT_SWITCH_ID。

備註

過度使用下列方式OID_NIC_SWITCH_PARAMETERS要求的問題：

超載驅動程式發出OID_NIC_SWITCH_PARAMETERS的 OID 方法要求，以取得指定 NIC 參數的目前參數。如需詳細資訊，請參閱查詢 NIC 參數。

注意 NDIS 會處理 PF 迷你埠驅動程式OID_NIC_SWITCH_PARAMETERS的 OID 方法要求。
超載驅動程式發出 OID 集合要求，OID_NIC_SWITCH_PARAMETERS變更指定 NIC 參數的目前參數。如需詳細資訊，請參閱設定 NIC 參數。

注意 PF 迷你埠驅動程式會處理OID_NIC_SWITCH_PARAMETERS的 OID 集合要求。

傳回狀態碼

NDIS 或 PF 迷你埠驅動程式會針對OID_NIC_SWITCH_PARAMETERS的 set 或 method OID 要求傳回下列狀態碼。

狀態碼	描述
NDIS_STATUS_SUCCESS	要求已順利完成。 InformationBuffer指向NDIS_NIC_SWITCH_CAPABILITIES結構。
NDIS_STATUS_NOT_SUPPORTED	PF 迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面，或未啟用介面。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_PARAMETERS結構的一或多個成員具有不正確值。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太短。 NDIS 或 PF 迷你埠驅動程式會設定 DATA。METHOD_INFORMATION。 OID 方法要求) 或 DATA 的 BytesNeeded 成員 (。SET_INFORMATION。OID 設定要求的 BytesNeeded 成員 (，NDIS_OID_REQUEST 結構中 ) 為所需的最小緩衝區大小。
NDIS_STATUS_REINIT_REQUIRED	PF 迷你埠驅動程式需要重新初始化網路介面卡，才能將變更套用至 NIC 交換器。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。