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

Статья
07/16/2024

Драйверы фильтров вызывают функцию 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 (include Ndis.h)
библиотеки	Ndis.lib
IRQL	<= DISPATCH_LEVEL

См. также

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

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

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