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

Статья
02/26/2024

Драйверы фильтров вызывают функцию 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 .

Драйверы фильтров также могут фильтровать запросы OID, которые создаются с помощью слишком избыточных драйверов. NDIS вызывает функцию FilterOidRequest для обработки каждого такого запроса.

Если NdisFOidRequest возвращает NDIS_STATUS_PENDING, NDIS вызывает функцию FilterOidRequestComplete после того, как базовые драйверы завершают запрос OID.

Если NdisFOidRequest возвращает NDIS_STATUS_SUCCESS, он возвращает результаты запроса в структуре NDIS_OID_REQUEST в параметре OidRequest .

NdisFOidRequest может возвращать NDIS_STATUS_INVALID_PARAMETER , если драйвер фильтра передает недопустимые значения для полей Тип и Размер в поле Заголовокструктуры NDIS_OID_REQUEST .

Драйвер может вызывать NdisFOidRequest , когда находится в состоянии Перезапуск, Выполняется, Приостановка или Приостановлено .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_OID_Function(ndis)