Функция 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 OIDs.
Возвращаемое значение
См. функцию NdisOidRequest.
Замечания
Драйверы фильтров могут создавать запросы OID к базовым драйверам путем вызова NdisFOidRequest.
Драйверы фильтров также могут фильтровать запросы OID, созданные путем чрезмерного изменения драйверов. NDIS вызывает функцию FilterOidRequest для обработки каждого такого запроса.
Если NdisFOidRequest возвращает NDIS_STATUS_PENDING, NDIS вызывает функцию FilterOidRequestComplet e после завершения запроса OID.
Если NdisFOidRequest возвращает NDIS_STATUS_SUCCESS, он возвращает результаты запроса в структуре NDIS_OID_REQUEST в параметре OidRequest.
NdisFOidRequest может возвращать NDIS_STATUS_INVALID_PARAMETER, если драйвер фильтра передает недопустимые значения для полей типа и размера в поле заголовка структуры NDIS_OID_REQUEST.
Драйвер может вызывать NdisFOidRequest при перезапуске, выполнении, приостановкеили приостановленном состоянии.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается в NDIS 6.0 и более поздних версиях. |
| целевая платформа | Настольный |
| заголовка | ndis.h (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | Irql_OID_Function(ndis) |