функция обратного вызова MINIPORT_CANCEL_OID_REQUEST (ndis.h)

Статья
08/07/2023

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

Примечание Функцию необходимо объявить с помощью типа MINIPORT_CANCEL_OID_REQUEST . Дополнительные сведения см. в следующем разделе Примеры.

Синтаксис

MINIPORT_CANCEL_OID_REQUEST MiniportCancelOidRequest;

void MiniportCancelOidRequest(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PVOID RequestId
)
{...}

Параметры

[in] MiniportAdapterContext

Дескриптор контекстной области, выделенной драйвером мини-порта в функции MiniportInitializeEx . Драйвер мини-порта использует эту контекстную область для хранения сведений о состоянии адаптера мини-порта.

[in] RequestId

Идентификатор отмены для запроса. Этот идентификатор указывает NDIS_OID_REQUEST структуры, которые отменяются.

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

None

Remarks

Драйвер указывает точку входа MiniportCancelOidRequest при вызовеФункция NdisMRegisterMiniportDriver.

Когда NDIS вызывает MiniportCancelOidRequest, драйвер мини-порта должен попытаться вызвать функцию NdisMOidRequestComplete как можно скорее .

Параметры запроса определяются в структуре NDIS_OID_REQUEST в OidRequest .

NDIS вызывает MiniportCancelOidRequest , когда инициатор запроса отменяет запрос или когда истекает время ожидания, указанное в элементе Timeout .

Если обработка запроса по-прежнему не завершена в драйвере мини-порта, драйвер вызывает функцию NdisMOidRequestComplete с состоянием NDIS_STATUS_REQUEST_ABORTED.

Если обработка запроса по-прежнему не завершена в промежуточном драйвере и запрос был распространен на базовый драйвер, промежуточный драйвер вызывает функцию NdisCancelOidRequest с параметром OidRequest , равным значению, которое он отправляет базовому драйверу.

NDIS вызывает MiniportCancelOidRequest в IRQL <= DISPATCH_LEVEL.

Примеры

Чтобы определить функцию MiniportCancelOidRequest , необходимо сначала предоставить объявление функции, определяющее тип определяемой функции. Windows предоставляет набор типов функций для драйверов. Объявление функции с помощью типов функций помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.

Например, чтобы определить функцию MiniportCancelOidRequest с именем MyCancelOidRequest, используйте тип MINIPORT_CANCEL_OID_REQUEST , как показано в этом примере кода:

MINIPORT_CANCEL_DIRECT_OID_REQUEST MyCancelOidRequest;

Затем реализуйте функцию следующим образом:

_Use_decl_annotations_
VOID
 MyCancelRequest(
    NDIS_HANDLE  MiniportAdapterContext,
    PVOID  RequestId
    )
  {...}

Тип функции MINIPORT_CANCEL_OID_REQUEST определен в файле заголовка Ndis.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, которые применяются к типу функции MINIPORT_CANCEL_OID_REQUEST в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов NDIS.

Сведения о Use_decl_annotations см. в статье О поведении функции.

Требования

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