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 OIDs。
傳回值
請參閱 NdisOidRequest 函式。
言論
篩選驅動程式可以呼叫 NdisFOidRequest來產生基礎驅動程式的 OID 要求。
篩選驅動程式也可以篩選過度驅動程序產生的 OID 要求。 NDIS 會呼叫 FilterOidRequest 函式來處理每個這類要求。
如果 NdisFOidRequest 傳回 NDIS_STATUS_PENDING,NDIS 會在基礎驅動程式完成 OID 要求之後呼叫 FilterOidRequestComplete 函式。
如果 NdisFOidRequest 傳回 NDIS_STATUS_SUCCESS,它會傳回 OidRequest 參數之 NDIS_OID_REQUEST 結構中查詢要求的結果。
NdisFOidRequest 如果篩選驅動程式在 NDIS_OID_REQUEST 結構的 Header 欄位中傳遞無效 Type 和 Size 字段的值,則可以傳回 NDIS_STATUS_INVALID_PARAMETER。
當驅動程式處於 重新啟動、執行、暫停或 暫停 狀態時,驅動程式可以呼叫 NdisFOidRequest。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_OID_Function(ndis) |