Bewerken

Delen via

DOT11EXT_NIC_SPECIFIC_EXTENSION callback function (wlanihv.h)

  • Artikel
Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

The IHV Extensions DLL calls the Dot11ExtNicSpecificExtension function to issue proprietary NDIS 6.0 method requests to the Native 802.11 miniport driver that manages a wireless LAN (WLAN) adapter.

Syntax

DOT11EXT_NIC_SPECIFIC_EXTENSION Dot11extNicSpecificExtension;

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

Parameters

[in, optional] hDot11SvcHandle

The handle used by the operating system to reference the WLAN adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

[in] dwInBufferSize

The size, in bytes, of the caller-allocated data buffer referenced by the pvInBuffer parameter.

[in] pvInBuffer

A pointer to a caller-allocated input buffer that contains the data required to perform the operation. The format of this data is defined by the IHV.

[in, out] pdwOutBufferSize

A pointer to a caller-allocated DWORD variable. When the Dot11ExtNicSpecificExtension function is called, the IHV Extensions DLL must set this variable to the size, in bytes, of the caller-allocated data buffer referenced by the pvOutBuffer parameter. When the function returns, the operating system sets the variable to the actual number of bytes returned in the data buffer referenced by the pvOutBuffer parameter.

[out] pvOutBuffer

A pointer to a caller-allocated buffer that contains data returned from the Native 802.11 miniport driver for the specified request. The format of this data is defined by the IHV. This parameter can be NULL if data is not to be returned by the Native 802.11 miniport driver.

Return value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

The Dot11ExtNicSpecificExtension function allows the IHV Extensions DLL to pass proprietary method requests to the Native 802.11 miniport driver, which is referenced by the hDot11SvcHandle parameter. The operating system issues the method request through the Native 802.11 OID_DOT11_NIC_SPECIFIC_EXTENSION object identifier (OID).

Note  OID_DOT11_NIC_SPECIFIC_EXTENSION is an optional OID for support by the Native 802.11 miniport driver. If the driver does not support this OID, Dot11ExtNicSpecificExtension will return a value of ERROR_NOT_SUPPORTED.

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header wlanihv.h (include Wlanihv.h)

See also

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter