DOT11EXT_NIC_SPECIFIC_EXTENSION fonction de rappel (wlanihv.h)

Article
03/05/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.

La DLL des extensions IHV appelle la fonction Dot11ExtNicSpecificExtension pour émettre des demandes de méthode NDIS 6.0 propriétaires au pilote miniport natif 802.11 qui gère un adaptateur LAN sans fil (WLAN).

Syntaxe

DOT11EXT_NIC_SPECIFIC_EXTENSION Dot11extNicSpecificExtension;

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

Paramètres

[in, optional] hDot11SvcHandle

Handle utilisé par le système d’exploitation 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 données allouée à l’appelant référencée par le paramètre pvInBuffer .

[in] pvInBuffer

Pointeur vers une mémoire tampon d’entrée allouée à l’appelant qui contient les données nécessaires à l’exécution de l’opération. Le format de ces données est défini par l’IHV.

[in, out] pdwOutBufferSize

Pointeur vers une variable DWORD allouée par l’appelant. Lorsque la fonction Dot11ExtNicSpecificExtension est appelée, les extensions IHV doivent définir cette variable sur la taille, en octets, de la mémoire tampon de données allouée à l’appelant référencée par le paramètre pvOutBuffer . Lorsque la fonction retourne, le système d’exploitation définit la variable sur le nombre réel d’octets retournés dans la mémoire tampon de données référencée par le paramètre pvOutBuffer .

[out] pvOutBuffer

Pointeur vers une mémoire tampon allouée à l’appelant qui contient les données retournées par le pilote miniport Native 802.11 pour la requête spécifiée. Le format de ces données est défini par l’IHV. Ce paramètre peut avoir la valeur NULL si les données ne doivent pas être retournées par le pilote miniport natif 802.11.

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

La fonction Dot11ExtNicSpecificExtension permet à la DLL des extensions IHV de transmettre des demandes de méthode propriétaires au pilote miniport Native 802.11, qui est référencé par le paramètre hDot11SvcHandle . Le système d’exploitation émet la demande de méthode via native 802.11 identificateur d’objet OID_DOT11_NIC_SPECIFIC_EXTENSION (OID).

Note OID_DOT11_NIC_SPECIFIC_EXTENSION est un OID facultatif pour la prise en charge par le pilote miniport Native 802.11. Si le pilote ne prend pas en charge cet OID, Dot11ExtNicSpecificExtension retourne une valeur de ERROR_NOT_SUPPORTED.

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

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter

Partager via