функция обратного вызова MINIPORT_DIRECT_OID_REQUEST (ndis.h)
NDIS вызывает функцию MiniportDirectOidRequest драйвера miniport Для обработки прямого запроса OID для запроса или задания сведений в драйвере.
Синтаксис
MINIPORT_DIRECT_OID_REQUEST MiniportDirectOidRequest;
NDIS_STATUS MiniportDirectOidRequest(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] PNDIS_OID_REQUEST OidRequest
)
{...}
Параметры
[in] MiniportAdapterContext
Дескриптор контекстной области, выделенной драйвером мини-порта в функции MiniportInitializeEx . Драйвер мини-порта использует эту контекстную область для хранения сведений о состоянии адаптера мини-порта.
[in] OidRequest
Указатель на структуру NDIS_OID_REQUEST , которая содержит буфер и пакет запроса для обработки драйвера мини-порта. В зависимости от запроса драйвер возвращает запрошенные сведения в предоставленной структуре.
Возвращаемое значение
MiniportDirectOidRequest может возвращать одно из следующих значений состояния:
| Код возврата | Описание |
|---|---|
|
Драйвер мини-порта установил или получил данные в соответствии с запросом. |
|
Драйвер мини-порта выполнит запрос асинхронно. После того как драйвер мини-порта завершит всю обработку, он должен вызвать Функция NdisMDirectOidRequestComplete, информирующая NDIS о том, что запрос завершен. |
|
Запрос, указанный OidRequest , является недопустимым или не распознанный. |
|
Запрос, указанный в OidRequest , распознается, но драйвер мини-порта не поддерживает его. |
|
Буфер, который предоставляет OidRequest , был слишком мал для хранения запрошенных данных. |
|
Значение, указанное в элементе InformationBufferLength структуры NDIS_OID_REQUEST в OidRequest , неверно для указанного кода OID_Xxx . |
|
Один или несколько параметров, указанных для запроса в OidRequest , были недопустимыми. |
|
После вызова Функция MiniportDevicePnPEventNotify, указывая на неожиданное удаление, NDIS называется функцией MiniportHaltEx драйвера. Если драйвер получил какие-либо запросы OID до вызова NDIS MiniportHaltEx, он должен немедленно завершить такие запросы со значением состояния NDIS_STATUS_NOT_ACCEPTED. |
|
Драйвер мини-порта остановил обработку запроса. Например, NDIS вызывает функцию MiniportResetEx . |
|
Драйвер мини-порта предоставит состояние завершения OID с последующим указанием состояния. Драйвер мини-порта не может вернуть NDIS_STATUS_INDICATION_REQUIRED, если это не разрешено определенным идентификатором OID. Чтобы определить, разрешено ли это состояние, см. страницу справочника по OID.. Дополнительные сведения о NDIS_STATUS_INDICATION_REQUIRED см. в разделе NDIS_OID_REQUEST и NDIS_STATUS_INDICATION. |
Комментарии
MiniportDirectOidRequest — это необязательная функция. Драйвер мини-порта регистрирует эту функцию, если обрабатывает прямые запросы OID. Драйвер указывает точку входа MiniportDirectOidRequest при вызовеФункция NdisMRegisterMiniportDriver. Драйвер мини-порта, который регистрируетФункция MiniportCancelDirectOidRequest также должна зарегистрировать MiniportDirectOidRequest.
NDIS вызывает функцию MiniportDirectOidRequest либо от своего имени, либо от имени драйвера связанного протокола, который вызвал функцию NdisDirectOidRequest . Драйверы минипорта должны изучить запрос, предоставленный в параметре OidRequest , и выполнить запрошенное действие.
Обратите внимание, что NDIS не проверяет содержимое OID в OidRequest. Поэтому сам драйвер должен проверить это содержимое. Если драйвер определяет, что заданное значение выходит за пределы границ, он должен завершить запрос и вернуть NDIS_STATUS_INVALID_DATA.
NDIS не сериализует запросы, отправляемые в MiniportDirectOidRequest , с другими запросами OID. Драйвер мини-порта должен иметь возможность обрабатывать несколько вызовов MiniportDirectOidRequest , если другие запросы, отправленные в MiniportOidRequest или MiniportDirectOidRequest , не выполняются.
Примеры
Чтобы определить функцию MiniportDirectOidRequest , необходимо сначала предоставить объявление функции, определяющее тип определяемой функции. Windows предоставляет набор типов функций для драйверов. Объявление функции с помощью типов функций помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.Например, чтобы определить функцию MiniportDirectOidRequest с именем MyDirectOidRequest, используйте тип MINIPORT_DIRECT_OID_REQUEST , как показано в этом примере кода:
MINIPORT_DIRECT_OID_REQUEST MyDirectOidRequest;
Затем реализуйте функцию следующим образом:
_Use_decl_annotations_
NDIS_STATUS
MyDirectOidRequest(
NDIS_HANDLE MiniportAdapterContext,
PNDIS_OID_REQUEST OidRequest
)
{...}
Тип функции MINIPORT_DIRECT_OID_REQUEST определен в файле заголовка Ndis.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует, что будут использоваться заметки, применяемые к типу функции MINIPORT_DIRECT_OID_REQUEST в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов NDIS.
Сведения о Use_decl_annotations см. в статье О поведении функции.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в NDIS 6.1 и более поздних версиях. |
| Целевая платформа | Windows |
| Header | ndis.h (включая Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |