DOT11EXT_SEND_PACKET funzione di callback (wlanihv.h)

Articolo
02/07/2025

importante L'interfaccia LAN wireless 802.1 1 nativa è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere modello di driver di Windows universale WLAN.

La DLL delle estensioni IHV chiama la funzione Dot11ExtSendPacket per trasmettere un pacchetto tramite la scheda LAN wireless (WLAN).

Sintassi

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

Parametri

[in, optional] hDot11SvcHandle

Handle utilizzato dal sistema operativo per fare riferimento all'adattatore WLAN. Questo valore di handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in] uPacketLen

Lunghezza, in byte, del buffer allocato dal chiamante a cui fa riferimento il parametro pvPacket.

[in] pvPacket

Puntatore a un buffer allocato dal chiamante che contiene i dati da trasmettere, come descritto nella sezione Osservazioni.

[in, optional] hSendCompletion

Valore handle che identifica in modo univoco il pacchetto di invio.

Quando l'adapter WLAN completa l'operazione di invio, il sistema operativo invia una notifica alla DLL delle estensioni IHV tramite una chiamata al funzione Dot11ExtIhvSendPacketCompletion IHV Handler. Quando si effettua questa chiamata, il sistema operativo passa il valore handle del pacchetto tramite il parametro hSendCompletion.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Osservazioni

La DLL delle estensioni IHV deve seguire queste linee guida quando si chiama la funzione dot11ExtSendPacket.

Il pacchetto inviato tramite una chiamata della funzione Dot11ExtSendPacket verrà completata in modo asincrono. La DLL delle estensioni IHV non deve liberare la memoria a cui fa riferimento il parametro pvPacket fino a quando il funzione Dot11ExtIhvSendPacketCompletion funzione IHV Handler viene chiamata con lo stesso valore di handle del parametro hSendCompletion.
La DLL delle estensioni IHV deve impostare il parametro hSendCompletion su un valore che identifica in modo univoco i dati del pacchetto a cui fa riferimento il parametro pvPacket.

Per altre informazioni sulle funzioni del gestore IHV, vedere Funzioni del gestore IHV 802.11 IHV.

Il buffer a cui punta pvPacket deve contenere i dati del pacchetto seguenti, specificati nell'ordine dei byte di rete:

Indirizzo MAC di destinazione (6 byte), formattato in base alle linee guida illustrate in gestione intestazione MAC 802.11
IEEE EtherType (2 byte)
Carico utile

Questi dati di pacchetto vengono passati al driver miniport.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Desktop
intestazione	wlanihv.h (include Wlanihv.h)

Vedere anche

Funzioni del gestore IHV native 802.11

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

gestione intestazione MAC 802.11

Condividi tramite