Dot11ExtSendPacket function

The IHV Extensions DLL calls the Dot11ExtSendPacket function to transmit a packet through the wireless LAN (WLAN) adapter.

Syntax


DWORD APIENTRY Dot11ExtSendPacket(
  _In_opt_  HANDLE hDot11SvcHandle,
  _In_      ULONG uPacketLen,
  _In_      LPVOID pvPacket,
  _In_opt_  HANDLE hSendCompletion
);

Parameters

hDot11SvcHandle [in, optional]

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.

uPacketLen [in]

The length, in bytes, of the caller-allocated buffer referenced by the pvPacket parameter.

pvPacket [in]

A pointer to a caller-allocated buffer that contains the data to be transmitted, as described in the Remarks section.

hSendCompletion [in, optional]

A handle value that uniquely identifies the send packet.

When the WLAN adapter completes the send operation, the operating system notifies the IHV Extensions DLL through a call to the Dot11ExtIhvSendPacketCompletion IHV Handler function. When making this call, the operating system passes the handle value of the packet through the hSendCompletion parameter.

Return value

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

Remarks

The IHV Extensions DLL must follow these guidelines when calling the Dot11ExtSendPacket function.

  • The packet sent through a call of the Dot11ExtSendPacket function will complete asynchronously. The IHV Extensions DLL must not free the memory referenced by the pvPacket parameter until the Dot11ExtIhvSendPacketCompletion IHV Handler function is called with the same handle value as the hSendCompletion parameter.

  • The IHV Extensions DLL must set the hSendCompletion parameter to a value that uniquely identifies the packet data that is referenced by the pvPacket parameter.

For more information about the IHV Handler functions, see Native 802.11 IHV Handler Functions.

The buffer pointed to by pvPacket should contain the following packet data, specified in network byte order:

  • MAC address of destination (6 bytes), formatted according to the guidelines discussed in 802.11 MAC Header Management

  • IEEE EtherType (2 bytes)

  • Payload

This packet data is passed to the miniport driver.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Wlanihv.h (include Wlanihv.h)

See also

802.11 MAC Header Management
Dot11ExtIhvInitAdapter
Dot11ExtIhvSendPacketCompletion
Native 802.11 IHV Handler Functions

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft