NdisFSynchronousOidRequest 函式 (ndis.h)
篩選驅動程式會呼叫 NdisFSynchronousOidRequest 函式,以產生新的同步 OID 要求,並將它發出給基礎驅動程式。
NDIS 6.81 和更新版本支援此函式。
語法
NDIS_STATUS NdisFSynchronousOidRequest(
[in] NDIS_HANDLE NdisFilterModuleHandle,
[in] NDIS_OID_REQUEST *OidRequest
);
參數
[in] NdisFilterModuleHandle
識別篩選模組的 NDIS 句柄。 NDIS 在呼叫 filterAttach 函式時,將句柄傳遞給篩選驅動程式。
[in] OidRequest
NDIS_OID_REQUEST 結構的指標,指定使用指定 OID_Xxx 程式代碼要求的作業。 結構可以指定 OID 查詢、集合或方法要求。
傳回值
此函式會傳回與 NdisDirectOidRequest相同的值,但NDIS_STATUS_PENDING永遠不會從此函式傳回。
言論
NdisFSynchronousOidRequest 函式無法用於一般 OID 要求。 針對一般 OID 要求,請改用 NdisFOidRequest 函式。 NdisFSynchronousOidRequest 只能用於 NDIS 支援的 OID 搭配同步 OID 介面使用。 大部分篩選驅動程式不需要呼叫 NdisFSynchronousOidRequest。
篩選驅動程序必須完成 FilterDetach,直到篩選驅動程式產生的任何同步 OID 要求完成為止。
篩選驅動程式不需要實作 FilterOidRequestComplete、FilterDirectOidRequestComplete、FilterSynchronousOidRequest或 FilterSynchronousOidRequestComplete,才能呼叫 NdisFSynchronousOidRequest。 正如其名稱所建議,同步 OID 要求一律會同步完成,因此沒有異步回呼。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1709 |
目標平臺 | 普遍 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
另請參閱
FilterSynchronousOidRequestComplete
NDIS 6.80 中的同步 OID 要求介面