DOT11EXT_NIC_SPECIFIC_EXTENSION funzione di callback (wlanihv.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless native 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 Dot11ExtNicSpecificExtension per emettere richieste proprietarie di metodi NDIS 6.0 al driver miniport nativo 802.11 che gestisce una scheda LAN wireless (WLAN).

Sintassi

DOT11EXT_NIC_SPECIFIC_EXTENSION Dot11extNicSpecificExtension;

DWORD Dot11extNicSpecificExtension(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInBufferSize,
  [in]           LPVOID pvInBuffer,
  [in, out]      DWORD *pdwOutBufferSize,
  [out]          LPVOID pvOutBuffer
)
{...}

Parametri

[in, optional] hDot11SvcHandle

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

[in] dwInBufferSize

Dimensioni, in byte, del buffer di dati allocato dal chiamante a cui fa riferimento il parametro pvInBuffer .

[in] pvInBuffer

Puntatore a un buffer di input allocato dal chiamante che contiene i dati necessari per eseguire l'operazione. Il formato di questi dati è definito dall'IHV.

[in, out] pdwOutBufferSize

Puntatore a una variabile DWORD allocata dal chiamante. Quando viene chiamata la funzione Dot11ExtNicSpecificExtension , la DLL delle estensioni IHV deve impostare questa variabile sulle dimensioni, in byte, del buffer di dati allocato dal chiamante a cui fa riferimento il parametro pvOutBuffer . Quando la funzione viene restituita, il sistema operativo imposta la variabile sul numero effettivo di byte restituiti nel buffer di dati a cui fa riferimento il parametro pvOutBuffer .

[out] pvOutBuffer

Puntatore a un buffer allocato dal chiamante che contiene i dati restituiti dal driver miniport nativo 802.11 per la richiesta specificata. Il formato di questi dati è definito dall'IHV. Questo parametro può essere NULL se i dati non devono essere restituiti dal driver miniport nativo 802.11.

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 funzione Dot11ExtNicSpecificExtension consente alla DLL delle estensioni IHV di passare richieste di metodi proprietari al driver miniport Nativo 802.11, a cui fa riferimento il parametro hDot11SvcHandle . Il sistema operativo invia la richiesta del metodo tramite native 802.11 OID_DOT11_NIC_SPECIFIC_EXTENSION identificatore di oggetto (OID).

Nota OID_DOT11_NIC_SPECIFIC_EXTENSION è un OID facoltativo per il supporto del driver miniport Nativo 802.11. Se il driver non supporta questo OID, Dot11ExtNicSpecificExtension restituirà un valore di ERROR_NOT_SUPPORTED.

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

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter

Condividi tramite