NdisFSetAttributes 函式 (ndis.h)
篩選驅動程式會呼叫 NdisFSetAttributes 函式來指定篩選模組內容區域。
語法
NDIS_STATUS NdisFSetAttributes(
[in] NDIS_HANDLE NdisFilterHandle,
[in] __drv_aliasesMem NDIS_HANDLE FilterModuleContext,
[in] PNDIS_FILTER_ATTRIBUTES FilterAttributes
);
參數
[in] NdisFilterHandle
識別此篩選模組的 NDIS 句柄。 NDIS 在 對 FilterAttach 函式的呼叫中,將句柄傳遞至篩選驅動程式。
[in] FilterModuleContext
此篩選模組的呼叫端配置內容區域。
[in] FilterAttributes
已配置之篩選驅動程式的指標 NDIS_FILTER_ATTRIBUTES 結構。
傳回值
NdisFSetAttributes 會傳回下列其中一個狀態值:
傳回碼 | Description |
---|---|
|
如果設定篩選驅動程序屬性,NdisFSetAttributes 會傳回NDIS_STATUS_SUCCESS。 |
|
NdisFSetAttributes 因為資源不足而失敗。 |
|
如果上述值都未套用,NdisFSetAttributes 會傳回NDIS_STATUS_FAILURE。 |
備註
篩選驅動程式會從其 FilterAttach 函式呼叫 NdisFSetAttributes,並將 NDIS 在 NdisFilterHandle 參數傳遞至 FilterAttach 的句柄傳遞。 NdisFSetAttributes 的 FilterModuleContext 參數會指定此篩選模組的內容區域。 NDIS 會將內容區域傳回篩選驅動程式,以呼叫 FilterSendNetBufferLists 等函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_Filter_Driver_Function (ndis) |