Compartilhar via

Dot11ExtNicSpecificExtension (Compact 2013)

  • Artigo

3/26/2014

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

Syntax

DWORD WINAPI Dot11ExtNicSpecificExtension(
  HANDLE hDot11SvcHandle,
  DWORD dwInBufferSize,
  LPVOID pvInBuffer,
  DWORD* pdwOutBufferSize,
  LPVOID pvOutBuffer
);

Parameters

  • hDot11SvcHandle
    [in] The handle that is 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.
  • dwInBufferSize
    [in] The size, in bytes, of the caller-allocated data buffer referenced by the pvInBuffer parameter.
  • pvInBuffer
    [in] 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.
  • pdwOutBufferSize
    [in] 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.
  • pvOutBuffer
    [in, out] 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 enables 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

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
OID_DOT11_NIC_SPECIFIC_EXTENSION
Native 802.11 IHV Extensions DLL