Функция NdisFOidRequest (ndis.h)
Драйверы фильтров вызывают функцию 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 к базовым драйверам путем вызова NdisFOidRequest.
Драйверы фильтров также могут фильтровать запросы 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) |