OID_NIC_SWITCH_PARAMETERS

發行項
03/13/2025

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

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

InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_NIC_SWITCH_PARAMETERS 結構的指標。

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

從先前 OID_NIC_SWITCH_ENUM_SWITCHES的 OID 方法要求。
從 NicSwitchArrayNDIS_BIND_PARAMETERS 結構的成員。 NDIS 會在 protocolBindAdapterEx函式的 BindParameters參數中傳遞這個結構的指標。
從 NicSwitchArrayNDIS_FILTER_ATTACH_PARAMETERS 結構的成員。 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。BytesNeeded 成員（適用於 OID 方法要求）或 DATA。SET_INFORMATION。bytesNeeded 成員（針對 OID 集合要求）NDIS_OID_REQUEST 結構中所需的最小緩衝區大小。
NDIS_STATUS_REINIT_REQUIRED	PF 迷你埠驅動程式需要重新初始化網路適配器，才能將變更套用至 NIC 交換器。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。