Функция 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

Дескриптор минипорта, предоставленный драйверу в 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 (include ndis.h)
IRQL PASSIVE_LEVEL

См. также

NdisPoll

NdisSetPollNotification

NDIS_POLL_CHARACTERISTICS

NdisDeregisterPoll