NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES

迷你埠驅動程式會在目前啟用的接收篩選功能變更時發出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 狀態指示。

注意 此狀態指示應該只由支援 NDIS 接收篩選的迷你埠驅動程式進行。

當迷你埠驅動程式發出此狀態指示時,會將NDIS_STATUS_INDICATION結構的StatusBuffer成員設定為NDIS_RECEIVE_FILTER_CAPABILITIES結構的指標。 驅動程式會使用目前啟用的接收篩選功能,初始化這個結構。

備註

NDIS 接收篩選準則用於下列 NDIS 介面:

迷你埠驅動程式會在下列其中一個條件成立時發出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 狀態指示:

  • 目前啟用的接收篩選功能會在單一網路介面卡上變更。 例如,接收篩選可以透過獨立硬體廠商所開發的管理應用程式來啟用或停用, (IHV) 。

  • 目前啟用的接收功能會變更屬於 MUX 中繼驅動程式所管理之負載平衡容錯移轉的一或多個網路介面卡 (LBFO) 小組。 如需詳細資訊,請參閱 NDIS MUX 中繼驅動程式

迷你埠驅動程式會在發出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 狀態指示時遵循下列步驟:

  1. 迷你埠會使用目前在網路介面卡上啟用的接收篩選功能,初始化 NDIS_RECEIVE_FILTER_CAPABILITIES 結構。

    當迷你埠驅動程式初始化Header成員時,會將HeaderType成員設定為 NDIS_OBJECT_TYPE_DEFAULT。 迷你埠驅動程式會將HeaderRevision成員設定為 NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2,並將 Size成員設定為 NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2。

  2. 迷你埠驅動程式會以下列方式初始化狀態指示 的NDIS_STATUS_INDICATION 結構:

    • StatusCode成員必須設定為NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES

    • StatusBuffer成員必須設定為NDIS_RECEIVE_FILTER_CAPABILITIES結構的位址。

    • StatusBufferSize成員必須設定為 sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES)

  3. 迷你埠驅動程式會呼叫 NdisMIndicateStatusEx來發出狀態指示。 驅動程式必須將指標傳遞給statusIndication參數NDIS_STATUS_INDICATION結構。

注意 過度配置驅動程式可以使用 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 狀態指示來判斷網路介面卡目前啟用的接收篩選功能。 或者,這些驅動程式也可以發出 OID_RECEIVE_FILTER_CURRENT_CAPABILITIES 的 OID 查詢要求,隨時取得目前啟用的接收篩選功能。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

Ndis.h (包括 Ndis.h)

另請參閱


NdisMIndicateStatusEx

NDIS_STATUS_INDICATION

NDIS_RECEIVE_FILTER_CAPABILITIES

OID_RECEIVE_FILTER_CURRENT_CAPABILITIES