NdisRegisterPoll-Funktion (poll.h)

Ein Miniporttreiber ruft die NdisRegisterPoll-Funktion auf, um ein Poll-Objekt bei NDIS zu registrieren.

Syntax

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
);

Parameter

[_In_] NdisHandle

Ein von NDIS bereitgestellter Miniporthandle, der dem Treiber im MiniportInitialize-Rückruf zugewiesen wird.

[_In_opt_] Context

Ein Zeiger auf einen Block des vom Treiber zugewiesenen Kontexts, in dem Informationen zum Poll-Objekt gespeichert werden. NDIS übergibt diese Kontextinformationen in Aufrufen von NdisPoll und NdisSetPollNotification.

[_In_] Characteristics

Ein Zeiger auf eine vom Treiber initialisierte NDIS_POLL_CHARACTERISTICS-Struktur .

[_Out_] PollHandle

Bei erfolgreicher Rückgabe enthält dieser Speicherort ein Handle für das neue Poll-Objekt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Treiber registrieren in der Regel ein Poll-Objekt für jeden RSS-Prozessor in ihrem MiniportInitialize-Rückruf .

Treiber sollten die NdisDeregisterPoll aufrufen, um die Registrierung des Poll-Objekts aufzuheben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11
Unterstützte Mindestversion (Server) Windows Server 2022
Kopfzeile poll.h (include ndis.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

NdisPoll

NdisSetPollNotification

NDIS_POLL_CHARACTERISTICS

NdisDeregisterPoll