DOT11EXT_SEND_PACKET wlanihv.h) (回呼函式

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

 

IHV 擴充功能 DLL 會呼叫 Dot11ExtSendPacket 函式，以透過無線 LAN (WLAN) 配接器傳輸封包。

語法

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

參數

[in, optional] hDot11SvcHandle

操作系統用來參考WLAN 配接器的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式所指定。

[in] uPacketLen

pvPacket 參數所參考之呼叫端配置緩衝區的長度，以位元組為單位。

[in] pvPacket

呼叫端配置的緩衝區指標，其中包含要傳輸的數據，如一節所述。

[in, optional] hSendCompletion

唯一識別傳送封包的句柄值。

當WLAN配接器完成傳送作業時，操作系統會透過呼叫 通知IHV擴充功能 DLL Dot11ExtIhvSendPacketCompletion IHV 處理程式函式。 進行此呼叫時，操作系統會透過 hSendCompletion 參數傳遞封包的句柄值。

傳回值

如果呼叫成功，函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。

備註

呼叫 Dot11ExtSendPacket 函式時，IHV 擴充功能 DLL 必須遵循這些指導方針。

• 透過 Dot11ExtSendPacket 函式呼叫傳送的封包將會以異步方式完成。 IHV 擴充功能 DLL 必須等到 之後， 才釋放 pvPacket 參數所參考的記憶體 Dot11ExtIhvSendPacketCompletion 使用 與 hSendCompletion 參數相同的句柄值呼叫 IHV Handler 函式。
• IHV 延伸模組 DLL 必須將 hSendCompletion 參數設定為可唯一識別 pvPacket 參數所參考封包數據的值。

如需 IHV 處理程式函式的詳細資訊，請參閱 Native 802.11 IHV 處理程式函式。

pvPacket 指向的緩衝區應該包含下列以網路位元組順序指定的封包資料：

• 目的地 (6 個字節的 MAC 位址) ，根據 802.11 MAC 標頭管理中所討論的指導方針格式化
• IEEE EtherType (2 個字節)
• 承載重量

此封包數據會傳遞至迷你埠驅動程式。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	wlanihv.h (包含 Wlanihv.h)

另請參閱

原生 802.11 IHV 處理程式函式

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 MAC 標頭管理