Функция NdisFSynchronousOidRequest (ndis.h)

Статья
08/07/2023

Драйверы фильтров вызывают функцию 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 можно использовать только для идентификаторов OID, поддерживаемых NDIS для использования с синхронным интерфейсом OID. Большинству драйверов фильтров не требуется вызывать NdisFSynchronousOidRequest.

Драйверы фильтров не должны выполнять filterDetach до тех пор, пока не будут завершены все синхронные запросы OID, созданные драйвером фильтра.

Драйверы фильтров не требуются для реализации FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequest или FilterSynchronousOidRequestComplete для вызова NdisFSynchronousOidRequest. Как следует из названия, синхронный запрос OID всегда выполняется синхронно, поэтому асинхронный обратный вызов отсутствует.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1709
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL

См. также раздел

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

Синхронный интерфейс запроса OID в NDIS 6.80

Поделиться через