funzione di callback DOT11EXTIHV_CONTROL (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.

Il sistema operativo chiama la DLL IHV Extensions Dot11ExtIhvControl funzione per consentire il controllo indipendente dei driver o dei servizi WLAN da parte del fornitore di hardware indipendente .

Sintassi

DOT11EXTIHV_CONTROL Dot11extihvControl;

DWORD Dot11extihvControl(
  [in, optional]  HANDLE hIhvExtAdapter,
  [in]            DWORD dwInBufferSize,
  [in, optional]  PBYTE pInBuffer,
  [in]            DWORD dwOutBufferSize,
  [out, optional] PBYTE pOutBuffer,
  [out]           PDWORD pdwBytesReturned
)
{...}

Parametri

[in, optional] hIhvExtAdapter

Handle utilizzato dalla DLL delle estensioni IHV per fare riferimento all'adattatore WLAN. Questo valore di handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in] dwInBufferSize

Dimensioni, in byte, del buffer di controllo di input a cui punta il parametro pInBuffer.

[in, optional] pInBuffer

Puntatore al buffer di controllo di input.

[in] dwOutBufferSize

Dimensioni, in byte, del buffer di output (se specificato) a cui punta il parametro pOutBuffer.

[out, optional] pOutBuffer

Puntatore al buffer di output, se specificato.

[out] pdwBytesReturned

Puntatore a una variabile contenente le dimensioni, in byte, del buffer di input/output della risposta.

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

Il sistema operativo chiama questa funzione quando viene chiamata la funzione WlanIhvControl con il parametro Type impostato su un valore di wlan_ihv_control_type_service. Per una descrizione della funzione WlanIhvControl, vedere la documentazione di Microsoft Windows SDK.

I dati trasferiti con questa funzione non vengono convalidati, pertanto l'IHV è responsabile dell'analisi corretta del buffer di input.

Verrà restituito sempre il buffer di dati a cui punta il parametro pdwBytesReturned. Tuttavia, il buffer a cui punta pOutBuffer verrà copiato solo se viene specificato un puntatore valido e il valore a cui punta pdwBytesReturned è minore o uguale a dwOutBufferSize .

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

Dot11ExtIhvInitAdapter

Condividi tramite