funzione NET_EXTENSION_QUERY_INIT (netadapterpacket.h)

  • Articolo

La funzione NET_EXTENSION_QUERY_INIT inizializza una struttura NET_EXTENSION_QUERY .

Sintassi

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

Parametri

[_Out_] Extension

Puntatore a una struttura di NET_EXTENSION_QUERY allocata dal driver.

[_In_] Name

Nome dell'estensione su cui eseguire una query.

[_In_] Version

Versione dell'estensione su cui eseguire query.

[_In_] Type

Valore NET_EXTENSION_TYPE che specifica il tipo di estensione su cui viene eseguito la query.

Valore restituito

nessuno

Osservazioni

Dopo aver chiamato questa funzione, passare la struttura NET_EXTENSION_QUERY inizializzata a NetTx(Rx)QueueGetExtension per ottenere l'offset a tale estensione nel descrittore di pacchetti o frammenti.

Per evitare che vengano rieseguite query troppo spesso, chiamare questa funzione e NetTx(Rx)QueueGetExtension dalla funzione di callback EvtNetAdapterCreateTx(Rx)Queue dopo aver chiamato NetTx(Rx)QueueCreate, quindi archiviare l'offset in uno spazio di contesto della coda.

Per altre informazioni sulle estensioni, vedi Descrittori di pacchetti ed estensioni.

Per un esempio di codice relativo all'esecuzione di query degli offset di estensione, vedere Trasmettere e ricevere code.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 2004
Piattaforma di destinazione Universale
Intestazione netadapterpacket.h (include netadaptercx.h)
IRQL Qualsiasi livello purché la memoria di destinazione sia residente

Vedi anche

Descrittori di pacchetti ed estensioni

Trasmettere e ricevere code

NET_EXTENSION_QUERY

NET_EXTENSION_TYPE