DOT11EXT_SEND_PACKET コールバック関数 (wlanihv.h)
大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバー モデル」を参照してください。
構文
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 パラメーターによって参照されるパケット データを一意に識別する値に設定する必要があります。
pvPacket が指すバッファーには、ネットワークのバイト順に指定された次のパケット データが含まれている必要があります。
- 802.11 MAC ヘッダー管理で説明されているガイドラインに従って書式設定された宛先の MAC アドレス (6 バイト)
- IEEE EtherType (2 バイト)
- ペイロード
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wlanihv.h (Wlanihv.h を含む) |