fonction de rappel DOT11EXT_NIC_SPECIFIC_EXTENSION (wlanihv.h)

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.

La DLL des extensions IHV appelle la fonction Dot11ExtNicSpecificExtension pour émettre des demandes de méthode NDIS 6.0 propriétaires adressées au pilote miniport Native 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 via un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter.

[in] dwInBufferSize

Taille, en octets, de la mémoire tampon de données allouée par l’appelant référencée par le paramètre pvInBuffer.

[in] pvInBuffer

Pointeur vers une mémoire tampon d’entrée allouée par l’appelant qui contient les données requises pour effectuer 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, la DLL d’extensions IHV doit définir cette variable sur la taille, en octets, de la mémoire tampon de données allouée par l’appelant référencée par le paramètre pvOutBuffer. Lorsque la fonction est retournée, 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 par 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 être NULL si les données ne doivent pas être retournées par le pilote miniport Native 802.11.

Valeur de retour

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, elle 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ée par le paramètre hDot11SvcHandle. Le système d’exploitation émet la demande de méthode via native 802.11 OID_DOT11_NIC_SPECIFIC_EXTENSION identificateur d’objet (OID).

Remarque 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	wlanihv.h (include Wlanihv.h)

Voir aussi

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter