NDIS_SET_POLL_NOTIFICATION callback function (poll.h)

Miniport drivers implement the NdisSetPollNotification callback function to enable or disable the interrupt associated with a Poll object.

Syntax

NDIS_SET_POLL_NOTIFICATION NdisSetPollNotification;

void() NdisSetPollNotification(
  [_In_]    void *Context,
  [_Inout_] NDIS_POLL_NOTIFICATION *Notification
)
{...}

Parameters

[_In_] Context

A pointer to the context information that the driver provided when it created the Poll object.

[_Inout_] Notification

A pointer to an NDIS_POLL_NOTIFICATION structure containing the interrupt state for the Poll object.

Remarks

Miniport drivers register the NdisSetPollNotification callback during miniport adapter initialization. Drivers specify an entry point for the NdisSetPollNotification function at the SetPollNotificationHandler parameter of the NDIS_POLL_CHARACTERISTICS structure before calling NdisRegisterPoll.

NDIS typically invokes the NdisSetPollNotification callback when it detects that the miniport driver is not making forward progress in NdisPoll. NDIS uses NdisSetPollNotification to tell the driver that it will stop invoking NdisPoll. The driver should invoke NdisRequestPoll when new work is ready to be processed.

Requirements

Requirement Value
Minimum supported client Windows 11
Minimum supported server Windows Server 2022
Header poll.h (include ndis.h)
IRQL <= DISPATCH_LEVEL

See also

NdisPoll

NdisRequestPoll

NDIS_POLL_NOTIFICATION

NDIS_POLL_CHARACTERISTICS

NdisRegisterPoll