NdisFOidRequest 函式 (ndis.h)
篩選驅動程式會呼叫 NdisFOidRequest 函式,將 OID 要求轉送至基礎驅動程式或產生這類要求。
語法
NDIS_STATUS NdisFOidRequest(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
參數
[in] NdisFilterHandle
識別篩選模組的 NDIS 句柄。 NDIS 在對 FilterAttach 函式的呼叫中,將句柄傳遞至篩選驅動程式。
[in] OidRequest
NDIS_OID_REQUEST 結構的指標,指定使用指定之 OID_XXX 程式代碼要求的作業。 結構可以指定查詢、集合或方法要求。 如需 OID 的詳細資訊,請參閱 NDIS OID。
傳回值
請參閱 NdisOidRequest 函式。
備註
篩選驅動程式可以藉由呼叫 NdisFOidRequest 來產生基礎驅動程式的 OID 要求。
篩選驅動程式也可以篩選源自於過度驅動程式的 OID 要求。 NDIS 會呼叫 FilterOidRequest 函式來處理每個這類要求。
如果 NdisFOidRequest 傳回NDIS_STATUS_PENDING,NDIS 會在基礎驅動程式完成 OID 要求之後呼叫 FilterOidRequestComplete 函式。
如果 NdisFOidRequest 傳回NDIS_STATUS_SUCCESS,它會在 OidRequest 參數的 NDIS_OID_REQUEST 結構中傳回查詢要求的結果。
如果篩選驅動程式在NDIS_OID_REQUEST結構的標頭欄位中傳遞無效的 Type 和 Size 欄位值,Ndis FOidRequest 可以傳回NDIS_STATUS_INVALID_PARAMETER。
當驅動程式處於重新啟動、執行中、暫停或暫停狀態時,可以呼叫 NdisFOidRequest。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_OID_Function (ndis) |