MINIPORT_CANCEL_SEND コールバック関数 (ndis.h)
NDIS は、ミニポート ドライバーの ミニポートCancelSend 関数を呼び出して、指定したキャンセル識別子でマークされているすべての NET_BUFFER_LIST 構造体の送信を取り消します。
構文
MINIPORT_CANCEL_SEND MiniportCancelSend;
void MiniportCancelSend(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] PVOID CancelId
)
{...}
パラメーター
[in] MiniportAdapterContext
ミニポート ドライバーがその ミニポートInitializeEx 関数に割り当てられたコンテキスト領域へのハンドル。 ミニポート ドライバーは、アダプターに関する状態情報を維持するには、このコンテキスト領域を使用します。
[in] CancelId
キャンセル識別子。 この識別子は、取り消される NET_BUFFER_LIST 構造体を指定します。
戻り値
何一つ
備考
ミニポート ドライバーとキュー NET_BUFFER_LIST 構造体を送信する中間ドライバーは、ミニポートCancelSend 関数をエクスポートします。 ミニポートCancelSend 関数は、指定したNET_BUFFER_LIST構造体の保留中の送信を取り消します。
上にある NDIS ドライバーが呼び出されたときNdisCancelSendNetBufferLists 関数、NDIS は、バインドに対する適切な下位レベルドライバーの ミニポートCancelSend 関数を呼び出します。 NDIS は、下位レベルのドライバーが ミニポートCancelSend 関数をエクスポートする場合にのみ、この呼び出しを行います。
ミニポート ドライバーの ミニポートCancelSend 関数は、次の操作を実行します。
- 指定したアダプターのキューに登録されたNET_BUFFER_LIST構造体の一覧を走査し、次の値を呼び出します。 NDIS_GET_NET_BUFFER_LIST_CANCEL_ID マクロを使用して、キューに登録された各NET_BUFFER_LIST構造体のキャンセル識別子を取得します。 ミニポート ドライバーは、NDIS_GET_NET_BUFFER_LIST_CANCEL_IDが返す取り消し識別子を、NDIS が ミニポートCancelSendに渡したキャンセル識別子と比較します。
- キャンセル識別子が指定されたキャンセル識別子と一致するすべてのNET_BUFFER_LIST構造体を送信キューから削除 (リンク解除) します。
- を呼び出します。 NdisMSendNetBufferListsComplete 構造体を返すすべてのリンクされていないNET_BUFFER_LIST構造体の関数です。ミニポート ドライバーは、NET_BUFFER_LIST構造体の状態フィールドをNDIS_STATUS_SEND_ABORTEDに設定します。
- ミニポート ドライバーの ミニポート CancelSend 関数の前の一覧の操作を実行します。
- を呼び出します。 NdisCancelSendNetBufferLists 関数。ミニポート CancelSend への呼び出しで NDIS が指定したアダプターにマップされるバインディング指定します。
の例
ミニポートCancelSend 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 関数の種類を使用して関数を宣言すると、ドライバー のコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。たとえば、"MyCancelSend" という名前の ミニポートCancelSend 関数を定義するには、次のコード例に示すように MINIPORT_CANCEL_SEND 型を使用します。
MINIPORT_CANCEL_SEND MyCancelSend;
次に、次のように関数を実装します。
_Use_decl_annotations_
VOID
MyCancelSend(
NDIS_HANDLE MiniportAdapterContext,
PVOID CancelId
)
{...}
MINIPORT_CANCEL_SEND 関数の種類は、Ndis.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations 注釈により、ヘッダー ファイル内の MINIPORT_CANCEL_SEND 関数型に適用される注釈が使用されます。 関数宣言の要件の詳細については、「ndis ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。
Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.0 以降でサポートされています。 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ndis.h (Ndis.h を含む) |
| IRQL | <= DISPATCH_LEVEL |