MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT コールバック関数 (dot11wdi.h)

  • [アーティクル]

重要

このトピックは、Windows 10でリリースされた WDI ドライバー モデルの一部です。 WDI ドライバー モデルはメンテナンス モードであり、優先度の高い修正のみを受け取ります。 WiFiCx は、Windows 11でリリースされた Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。

TxSuspectFrameListAbort コールバック関数は、IHV ミニポートによって実装され、TxMgr が長時間にわたってハングまたは保留中の完了の疑いがあるフレームを TxEngine に識別したことを TxEngine に通知します。

構文

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

void MiniportWdiTxSuspectFrameListAbort(
  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  UINT64 SuspectFrameContext,
  UINT16 NumSuspectFrames,
  PNET_BUFFER_LIST *SuspectFrameList
)
{...}

パラメーター

MiniportTalTxRxContext

ミニポートWdiTalTxRxInitialize の IHV ミニポートによって返される TAL デバイス ハンドル。

SuspectFrameContext

疑わしいフレームに関するコンテキスト情報。

NumSuspectFrames

疑わしいフレームの数。

SuspectFrameList

疑わしいフレームの一覧。 詳細については、「解説」を参照してください。

戻り値

なし

解説

このコールバック関数の実装を登録するには、 NDIS_MINIPORT_WDI_DATA_HANDLERS 構造体の適切なメンバーを設定します。

これは省略可能なハンドラーです。 IHV ミニポートがこのコールバックの動作を実装していない場合は、 NDIS_MINIPORT_WDI_DATA_HANDLERS で関数ポインターを設定しないでください。WDI はこのハンドラーを呼び出しません。 ただし、このコールバックの動作が実装されていない場合でも、IHV ミニポートが SuspectFrameList を使用して診断目的で IHV 状態をログに記録する場合は、関数ポインターが設定されている可能性があります。

このコールバック関数は、TxMgr が長時間ハングまたは保留中の完了の疑いがあるフレームを TxEngine に識別したことを通知します。 NBL ポインターの SuspectFrameList 配列 (Next ポインターは適用できません) は、その結果フレームが空中で送信されない場合でも、TxMgr がプロンプト完了を要求しているフレームを表します。

TxEngine は、SuspectFrameContext がハンドラーに渡された TxSuspectFrameListAbort のコンテキストから TxQuerySuspectFrameStatus を呼び出すことによって、SuspectFrameList 配列内の NBL の状態をチェックする場合があります。 TxMgr は、TxSuspectFrameAbort の期間中に SuspectFrameList 内の任意の NBL に対して TxTargetDescDeinit を呼び出さなかったり、NDIS にフレームを完了したりしません。

TxEngine またはファームウェアに疑わしいフレームの知識や状態がない場合は、システムの破損や二重補完の原因になる可能性があるため、その疑わしいフレームの完了を発行しないでください。

ファームウェアの停止または破損が検出された場合は、回復を試みるために NDIS_STATUS_WDI_INDICATION_FIRMWARE_STALLED 通知を行う必要があります。

要件

要件 値
Header dot11wdi.h