共用方式為

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 可延伸交換器處理程式函式。

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

傳回值

如果呼叫成功， 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 和更新版本支援。
目標平台 Universal
標頭 ndis.h (包括 Ndis.h)
程式庫 Ndis.lib
IRQL <= DISPATCH_LEVEL

另請參閱

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS