閱讀英文

共用方式為

NdisFGetOptionalSwitchHandlers 函式 （ndis.h）

  • 發行項

Hyper-V 可延伸交換器擴充功能會呼叫 NdisFGetOptionalSwitchHandlers 函式，以取得 Hyper-V 可延伸交換器處理程式函式的指標清單。

語法

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

參數

[in] NdisFilterHandle

識別此篩選模組的 NDIS 句柄。 當 NDIS 呼叫擴充功能的 FilterAttach 函式時，它會在 NdisFilterHandle 參數中傳遞此句柄。

[out] NdisSwitchContext

NDIS_SWITCH_CONTEXT值的指標，識別附加延伸模組的可延伸交換器模組。 當擴充功能呼叫可延伸交換器處理程式函式時，它必須將 NdisSwitchContext 參數設定為此句柄的值。

[in, out] NdisSwitchHandlers

呼叫端配置的 NDIS_SWITCH_OPTIONAL_HANDLERS 結構的指標。 如果呼叫成功，此結構將會包含可延伸交換器處理程式函式的指標清單。

如需這些處理程式函式的詳細資訊，請參閱 Hyper-V 可延伸交換器處理程式函式。

Note 在擴充功能呼叫 NdisFGetOptionalSwitchHandlers之前，它必須初始化 NDIS_SWITCH_OPTIONAL_HANDLERS 結構的 標頭 成員。
 

傳回值

如果呼叫成功，NdisFGetOptionalSwitchHandlers 會傳回NDIS_STATUS_SUCCESS。 否則，如果可延伸交換器延伸模組未系結至基礎可延伸交換器元件，則會傳回NDIS_STATUS_NOT_SUPPORTED。

言論

延伸模組會從 FilterAttach 函式呼叫 NdisFGetOptionalSwitchHandlers 函式。

如果擴充功能已安裝多個 FilterMediaTypes INF 專案，則呼叫 NdisFGetOptionalSwitchHandlers 可讓延伸模塊判斷它是否已繫結並附加至可延伸交換器或實體網路適配器的驅動程式堆疊。 如果呼叫傳回NDIS_STATUS_SUCCESS，擴充功能會附加在可延伸交換器驅動程式堆疊內。 如果呼叫傳回NDIS_STATUS_NOT_SUPPORTED，擴充功能會附加在實體網路適配器的驅動程式堆疊內。

如需 FilterMediaTypes 可延伸交換器擴充功能之 INF 專案的詳細資訊，請參閱 Hyper-V 可延伸交換器擴充功能的 INF 需求。

要求

要求 價值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
目標平臺 普遍
標頭 ndis.h （包括 Ndis.h）
連結庫 Ndis.lib
IRQL <= DISPATCH_LEVEL

另請參閱

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS