DOT11EXT_SEND_PACKET funzione di callback (wlanihv.h)

Articolo
02/27/2024

Importante L'interfaccia LAN wireless nativa 802.11 è 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 windows universale WLAN.

La DLL delle estensioni IHV chiama la funzione Dot11ExtSendPacket per trasmettere un pacchetto tramite l'adattatore 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 usato 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 del 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'adattatore WLAN completa l'operazione di invio, il sistema operativo notifica la DLL delle estensioni IHV tramite una chiamata a Dot11ExtIhvSendPacketCompletion Funzione gestore IHV. Quando si esegue questa chiamata, il sistema operativo passa il valore di 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.

Commenti

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 non viene Dot11ExtIhvSendPacketCompletion La funzione gestore IHV 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 native 802.11.

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

Indirizzo MAC di destinazione (6 byte), formattato in base alle linee guida illustrate nella gestione delle intestazioni MAC 802.11
IEEE EtherType (2 byte)
Payload

Questi dati di pacchetto vengono passati al driver miniport.

Requisiti

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)

Vedi anche

Funzioni del gestore IHV nativo 802.11

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

Gestione intestazioni MAC 802.11

Condividi tramite