DOT11EXT_NIC_SPECIFIC_EXTENSION callback function (wlanihv.h)

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

Requirements

See also

Dot11ExtIhvInitAdapter