NdisFDirectOidRequest 函式 (ndis.h)
篩選驅動程式會呼叫 NdisFDirectOidRequest 函式,將直接 OID 要求轉送至基礎驅動程式或產生這類要求。
語法
NDIS_STATUS NdisFDirectOidRequest(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
參數
[in] NdisFilterHandle
識別篩選模組的 NDIS 句柄。 NDIS 在對 FilterAttach 函式的呼叫中,將句柄傳遞至篩選驅動程式。
[in] OidRequest
NDIS_OID_REQUEST 結構的指標,指定使用指定之 OID_Xxx 程式代碼要求的作業。 結構可以指定 OID 查詢、設定或方法要求。
傳回值
如需可能的傳回值清單,請參閱 NdisDirectOidRequest 函式。
備註
NdisFDirectOidRequest 函式無法用於一般 OID 要求。 針對一般 OID 要求,請改用 NdisFOidRequest 函式。 NdisFDirectOidRequest 只能用於 NDIS 支援的 OID,以便與直接 OID 介面搭配使用。 例如,可以使用下列 OID:
OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA篩選驅動程式可以呼叫 NdisFDirectOidRequest,將 OID 要求導向至基礎驅動程式。
篩選驅動程式也可以篩選源自於過度驅動程式的直接 OID 要求。 NDIS 會呼叫 FilterDirectOidRequest 函式來處理每個這類要求。
如果 NdisFDirectOidRequest 傳回NDIS_STATUS_PENDING,NDIS 會在基礎驅動程式完成 OID 要求之後呼叫 FilterDirectOidRequestComplete 函式。 呼叫 NdisFDirectOidRequest 的驅動程序必須註冊 FilterDirectOidRequestComplete 函式 。
當驅動程式處於重新啟動、執行中、暫停或暫停狀態時,可以呼叫 NdisFDirectOidRequest。
直接 OID 要求介面類似於一般 OID 要求介面。 如需發出一般要求的詳細資訊,請參閱 NdisFOidRequest。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.1 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |