Freigeben über


NET_EXTENSION_QUERY_INIT-Funktion (netadapterpacket.h)

Die NET_EXTENSION_QUERY_INIT-Funktion initialisiert eine NET_EXTENSION_QUERY-Struktur .

Syntax

void NET_EXTENSION_QUERY_INIT(
  [_Out_] NET_EXTENSION_QUERY *Extension,
  [_In_]  PCWSTR              Name,
  [_In_]  ULONG               Version,
  [_In_]  NET_EXTENSION_TYPE  Type
);

Parameter

[_Out_] Extension

Ein Zeiger auf eine vom Treiber zugewiesene NET_EXTENSION_QUERY-Struktur .

[_In_] Name

Der Name der abzufragten Erweiterung.

[_In_] Version

Die Version der erweiterung, die abgefragt werden soll.

[_In_] Type

Ein NET_EXTENSION_TYPE Wert, der den Typ der abgefragten Erweiterung angibt.

Rückgabewert

Keine

Bemerkungen

Übergeben Sie nach dem Aufrufen dieser Funktion die initialisierte NET_EXTENSION_QUERY Struktur an NetTx(Rx)QueueGetExtension , um den Offset an diese Erweiterung im Paket- oder Fragmentdeskriptor abzurufen.

Um zu verhindern, dass Erweiterungsoffsets zu häufig erneut abgefragt werden, rufen Sie diese Funktion und NetTx(Rx)QueueGetExtension über die Funktion EvtNetAdapterCreateTx(Rx)Queue Callback nach dem Aufruf von NetTx(Rx)QueueCreate auf, und speichern Sie den Offset dann in einem Warteschlangenkontextbereich.

Weitere Informationen zu Erweiterungen finden Sie unter Paketdeskriptoren und -erweiterungen.

Ein Codebeispiel zum Abfragen von Erweiterungsoffsets finden Sie unter Übertragungs- und Empfangswarteschlangen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004
Zielplattform Universell
UMDF-Mindestversion 2.33
Kopfzeile netadapterpacket.h (include netadaptercx.h)
IRQL Jede Ebene, solange der Zielspeicher resident ist

Weitere Informationen

Paketdeskriptoren und -erweiterungen

Übertragungs- und Empfangswarteschlangen

NET_EXTENSION_QUERY

NET_EXTENSION_TYPE