共用方式為

DOT11EXT_SEND_PACKET回呼函式 （wlanihv.h）

  • 發行項
重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。 請改用 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 Handler 函式。 進行此呼叫時，作系統會透過 hSendCompletion 參數傳遞封包的句柄值。

傳回值

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

言論

呼叫 Dot11ExtSendPacket 函式時，IHV 延伸模組 DLL 必須遵循這些指導方針。

  • 透過 dot11ExtSendPacket 函式呼叫所傳送的封包將會以異步方式完成。 IHV 延伸模組 DLL 不得釋放 pvPacket 參數所參考的記憶體，直到 Dot11ExtIhvSendPacketCompletion IHV Handler 函式會呼叫，其句柄值與 hSendCompletion 參數相同。
  • IHV 延伸模組 DLL 必須將 hSendCompletion 參數設定為值，以唯一識別 pvPacket 參數所參考的封包數據。
如需 IHV 處理程式函式的詳細資訊，請參閱 Native 802.11 IHV 處理程式函式。

pvPacket 所指向的緩衝區 應包含下列封包數據，以網路位元組順序指定：

  • 目的地的 MAC 位址（6 個字節），格式是根據 802.11 MAC 標頭管理
  • IEEE EtherType （2 個字節）
  • 有效載荷
此封包數據會傳遞至迷你埠驅動程式。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺 桌面
標頭 wlanihv.h （包括 Wlanihv.h）

另請參閱

原生 802.11 IHV 處理程式函式

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 MAC 標頭管理