DOT11EXT_SEND_PACKET コールバック関数 (wlanihv.h)

重要Native 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 ハンドラー関数への以前の呼び出しによって指定されました。

[in] uPacketLen

pvPacket パラメーターによって参照される呼び出し元割り当てバッファーの長さ (バイト単位)。

[in] pvPacket

「解説」セクションで説明されているように、送信するデータを含む呼び出し元によって割り当てられたバッファーへのポインター。

[in, optional] hSendCompletion

送信パケットを一意に識別するハンドル値。

WLAN アダプターが送信操作を完了すると、オペレーティング システムは IHV 拡張機能 DLL に対する呼び出しを通じて通知します。dot11ExtIhvSendPacketCompletion IHV ハンドラー関数を します。 この呼び出しを行うと、オペレーティング システムは、hSendCompletion パラメーターを介してパケットのハンドル値を渡します。

戻り値

呼び出しが成功した場合、関数はERROR_SUCCESSを返します。 それ以外の場合は、Winerror.h で定義されているエラー コードが返されます。

備考

IHV 拡張機能 DLL は、Dot11ExtSendPacket 関数を呼び出すときに、これらのガイドラインに従う必要があります。

• Dot11ExtSendPacket 関数の呼び出しを介して送信されたパケットは、非同期的に完了します。 IHV 拡張 DLL は、pvPacket パラメーターによって参照されるメモリを解放しないでください。 Dot11ExtIhvSendPacketCompletion IHV ハンドラー関数は、hSendCompletion パラメーターと同じハンドル値を使用して呼び出されます。
• IHV 拡張機能 DLL は、hSendCompletion パラメーターを、pvPacket パラメーターによって参照されるパケット データを一意に識別する値に設定する必要があります。

IHV ハンドラー関数の詳細については、「ネイティブ 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 ヘッダー管理