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

Статья
08/07/2023

Драйверы фильтров вызывают функцию NdisFDirectOidRequest для пересылки прямого запроса OID базовым драйверам или для создания такого запроса.

Синтаксис

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

Параметры

[in] NdisFilterHandle

Дескриптор NDIS, идентифицирующий модуль фильтра. NDIS передал дескриптор драйверу фильтра в вызове функции FilterAttach .

[in] OidRequest

Указатель на структуру NDIS_OID_REQUEST , указывающую операцию, запрашиваемую с заданным кодом OID_Xxx . Структура может указывать запрос OID, набор или запрос метода.

Возвращаемое значение

Список возможных возвращаемых значений см. в разделе Функция NdisDirectOidRequest .

Функцию NdisFDirectOidRequest нельзя использовать для общих запросов OID. Для общих запросов OID используйте функцию NdisFOidRequest . NdisFDirectOidRequest можно использовать только для идентификаторов OID, поддерживаемых NDIS для использования с прямым интерфейсом OID. Например, можно использовать следующие идентификаторы OID:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA

Драйверы фильтров могут создавать прямые запросы OID к базовым драйверам путем вызова NdisFDirectOidRequest.

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

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

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

Интерфейс прямого запроса OID аналогичен общему интерфейсу запроса OID. Дополнительные сведения об отправке общих запросов см. в разделе NdisFOidRequest.

Требования

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