Функция NdisRegisterPoll (poll.h)

  • Статья

Драйвер мини-порта вызывает функцию NdisRegisterPoll для регистрации объекта Poll с помощью NDIS.

Синтаксис

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisRegisterPoll(
  [_In_]     NDIS_HANDLE                     NdisHandle,
  [_In_opt_] void                            *Context,
  [_In_]     NDIS_POLL_CHARACTERISTICS const *Characteristics,
  [_Out_]    NDIS_POLL_HANDLE                *PollHandle
);

Параметры

[_In_] NdisHandle

Предоставленный NDIS дескриптор минипорта, предоставленный драйверу в обратном вызове MiniportInitialize .

[_In_opt_] Context

Указатель на блок контекста, выделенного драйвером, в котором хранятся сведения об объекте Poll. NDIS передает эти сведения о контексте в вызовах NdisPoll и NdisSetPollNotification.

[_In_] Characteristics

Указатель на инициализированную драйвером структуру NDIS_POLL_CHARACTERISTICS .

[_Out_] PollHandle

При успешном возвращении это расположение содержит дескриптор для нового объекта Poll.

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

Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращает код ошибки NTSTATUS .

Комментарии

Драйверы обычно регистрируют один объект Poll для каждого обработчика RSS в обратном вызове MiniportInitialize .

Драйверы должны вызывать NdisDeregisterPoll , чтобы отменить регистрацию объекта Poll.

Требования

Требование Значение
Минимальная версия клиента Windows 11
Минимальная версия сервера Windows Server 2022
Верхняя часть poll.h (включая ndis.h)
IRQL PASSIVE_LEVEL

См. также раздел

NdisPoll

NdisSetPollNotification

NDIS_POLL_CHARACTERISTICS

NdisDeregisterPoll