DOT11EXTIHV_CONTROL fonction de rappel (wlanihv.h)

Article
03/01/2024

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

Le système d’exploitation appelle la fonction Dot11ExtIhvControl dll des extensions IHV pour permettre au fournisseur de matériel indépendant (IHV) de contrôler les pilotes ou services WLAN.

Syntaxe

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
)
{...}

Paramètres

[in, optional] hIhvExtAdapter

Handle utilisé par la DLL d’extensions IHV pour référencer l’adaptateur WLAN. Cette valeur de handle a été spécifiée lors d’un appel précédent à la fonction gestionnaire IHV Dot11ExtIhvInitAdapter .

[in] dwInBufferSize

Taille, en octets, de la mémoire tampon de contrôle d’entrée pointée vers le paramètre pInBuffer .

[in, optional] pInBuffer

Pointeur vers la mémoire tampon de contrôle d’entrée.

[in] dwOutBufferSize

Taille, en octets, de la mémoire tampon de sortie (si fournie) pointée par le paramètre pOutBuffer .

[out, optional] pOutBuffer

Pointeur vers la mémoire tampon de sortie, s’il est fourni.

[out] pdwBytesReturned

Pointeur vers une variable qui contient la taille, en octets, de la mémoire tampon d’entrée/sortie de la réponse.

Valeur retournée

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, il retourne un code d’erreur défini dans Winerror.h.

Remarques

Le système d’exploitation appelle cette fonction lorsque la fonction WlanIhvControl est appelée avec le paramètre Type défini sur la valeur wlan_ihv_control_type_service. Pour obtenir une description de la fonction WlanIhvControl, consultez la documentation Microsoft Windows SDK.

Les données transférées avec cette fonction ne sont pas validées. L’IHV est donc responsable de l’analyse correcte de la mémoire tampon d’entrée.

La mémoire tampon de données pointée par le paramètre pdwBytesReturned sera toujours retournée. Toutefois, la mémoire tampon pointée vers pOutBuffer ne sera copiée que si un pointeur valide est fourni et que la valeur pointée par pdwBytesReturned est inférieure ou égale à dwOutBufferSize .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wlanihv.h (inclure Wlanihv.h)

Voir aussi

Dot11ExtIhvInitAdapter

Partager via