PROTOCOL_UNBIND_ADAPTER_EXコールバック関数 (ndis.h)

[アーティクル]
02/07/2025

NDIS は、基になるミニポートアダプターからバインドを解除するドライバーを要求するプロトコルドライバーの ProtocolUnbindAdapterEx 関数を呼び出します。

注PROTOCOL_UNBIND_ADAPTER_EX 型を使用して関数を宣言する必要があります。詳細については、次の例のセクションを参照してください。

構文

PROTOCOL_UNBIND_ADAPTER_EX ProtocolUnbindAdapterEx;

NDIS_STATUS ProtocolUnbindAdapterEx(
  [in] NDIS_HANDLE UnbindContext,
  [in] NDIS_HANDLE ProtocolBindingContext
)
{...}

パラメーター

[in] UnbindContext

このバインド解除操作の NDIS コンテキスト領域を識別するハンドル。

[in] ProtocolBindingContext

プロトコルドライバーによって割り当てられたコンテキスト領域へのハンドル。プロトコルドライバーは、バインディングごとのコンテキスト情報をこのコンテキスト領域に保持します。ドライバーは、ドライバーが ndisOpenAdapterEx 関数呼び出したときに NDIS にこのハンドルを提供しました。

戻り値

ProtocolUnbindAdapterEx は、次のいずれかの状態値を返します。

リターンコード	形容
NDIS_STATUS_SUCCESS	ProtocolUnbindAdapterEx 基になるミニポートアダプターから正常にバインド解除されます。
NDIS_STATUS_PENDING	ProtocolUnbindAdapterEx はバインド解除操作を完了せず、操作は非同期的に完了します。プロトコルドライバーは、次のコマンドを呼び出す必要があります。バインド解除操作の完了後に NdisCompleteUnbindAdapterEx 関数をします。

備考

ProtocolUnbindAdapterEx は必須の関数です。 ProtocolBindAdapterEx 関数の逆数として、NDIS は ProtocolUnbindAdapterEx を呼び出して、ドライバーがバインドに固有のネットワーク I/O 操作に割り当てたリソースを解放します。プロトコルドライバーは、バインド解除操作を失敗できません。

ProtocolUnbindAdapterEx を呼び出す前に、NDIS はプロトコルバインディングを一時停止します。バインドを一時停止するために、NDIS は ProtocolNetPnPEvent 関数を呼び出し、NetEventPause イベントを指定します。

ProtocolUnbindAdapterEx 基になるミニポートアダプターへのバインドを閉じるには、NdisCloseAdapterEx 関数を呼び出す必要があります。 NdisCloseAdapterEx NDIS_STATUS_SUCCESSが返された場合、閉じる操作は完了です。 NdisCloseAdapterEx がNDIS_STATUS_PENDINGを返す場合、NDIS はプロトコルドライバーを呼び出します。 ProtocolCloseAdapterCompleteEx 関数は、閉じる操作が完了した後です。

NdisCloseAdapterEx 呼び出す前に、プロトコルドライバーは、バインディングのマルチキャストアドレス一覧とパケットフィルターをクリアする必要があります。プロトコルドライバーは、バインディングマルチキャストアドレス一覧を NULL をし、パケットフィルターを 0 に設定します。詳細については、OID_802_3_MULTICAST_LIST と OID_GEN_CURRENT_PACKET_FILTER.

ウェイクアップパターンが指定されている場合、プロトコルドライバーは、OID_PNP_REMOVE_WAKE_UP_PATTERN OID でそれを削除し、OID_GEN_RECEIVE_SCALE_PARAMETERS OID を使用して受信側のスケーリングパラメーターをクリアする必要があります。 NDIS 6.20 以降のプロトコルドライバーは、OID_PM_REMOVE_WOL_PATTERN OID で wake-on-LAN パターンを削除し、OID_PM_REMOVE_PROTOCOL_OFFLOAD OID で低電力プロトコルオフロードを削除する必要があります。

ProtocolUnbindAdapterEx は、閉じる操作が完了するまで、ProtocolBindingContext でメモリを解放しないでください。 NDIS は、ProtocolCloseAdapterCompleteEx ProtocolBindingContext のハンドル渡します。

プロトコルドライバーがバインド解除操作を完了した場合は、ProtocolUnbindAdapterEx NDIS_STATUS_SUCCESSを返すことができます。 NdisCloseAdapterEx がNDIS_STATUS_PENDINGを返す場合、ProtocolUnbindAdapterEx は、NDIS が protocolCloseAdapterCompleteEx を呼び出すのを待ってから、 NDIS_STATUS_SUCCESSを返す必要があります。

ProtocolUnbindAdapterEx NDIS_STATUS_PENDINGを返して、バインド解除操作の完了を後で延期できます。 ProtocolUnbindAdapterEx がNDIS_STATUS_PENDINGを返す場合、ドライバーは最終的に関数をして、バインド解除操作を完了します。 NdisCloseAdapterEx 関数がNDIS_STATUS_PENDING返された場合、ドライバーは ProtocolCloseAdapterCompleteExでバインド解除操作を完了できます。 ProtocolUnbindAdapterEx は、NdisCloseAdapterExを呼び出す前に、ProtocolBindingContext のコンテキスト領域にある UnbindContext にハンドルを格納できます。 ProtocolUnbindAdapterEx ハンドルを格納 場合、ProtocolCloseAdapterCompleteEx はハンドルを渡して NdisCompleteUnbindAdapterEx をしてバインド解除操作を完了できます。

ProtocolUnbindAdapterEx が NdisCloseAdapterEx 呼び出されると、NdisBindingHandle パラメーターの NdisOpenAdapterEx 関数から取得したハンドルが無効になります。 ProtocolUnbindAdapterEx は、このハンドルを使用して NdisXxx関数後続の呼び出しを行うことはできません。ドライバーは、閉じる操作が完了するまで、基になるミニポートアダプターから受信と状態の表示を取得できます。

NDIS は、IRQL = PASSIVE_LEVEL で ProtocolUnbindAdapterEx 呼び出します。

電源管理と RSS 設定の更新の

NDIS 6.0 および 6.1 プロトコルドライバーは、必要に応じて、次の操作を実行する必要があります。

を使用して、ミニポートアダプターから電源管理ウェイクオン LAN (WOL) パターンを削除します。 OID_PNP_REMOVE_WAKE_UP_PATTERN OID。
を使用して、受信側のスケーリングパラメーターをクリアします。 OID_GEN_RECEIVE_SCALE_PARAMETERS OID。

NDIS 6.20 以降のプロトコルドライバーは、次の操作を実行する必要があります。

OID_PM_REMOVE_WOL_PATTERN OID を使用して、ミニポートアダプターから電源管理の WOL パターンを削除します。
ミニポートアダプターから電源管理プロトコルオフロードを削除します。 OID_PM_REMOVE_PROTOCOL_OFFLOAD OID。

の例

ProtocolUnbindAdapterEx 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数の種類のセットが用意されています。関数の種類を使用して関数を宣言すると、ドライバーのコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティングシステムのドライバーを記述するための要件になります。

たとえば、"MyUnbindAdapterEx" という名前の ProtocolUnbindAdapterEx 関数を定義するには、次のコード例に示すように PROTOCOL_UNBIND_ADAPTER_EX 型を使用します。

PROTOCOL_UNBIND_ADAPTER_EX MyUnbindAdapterEx;

次に、次のように関数を実装します。

_Use_decl_annotations_
NDIS_STATUS
 MyUnbindAdapterEx(
    NDIS_HANDLE  UnbindContext,
    NDIS_HANDLE  ProtocolBindingContext
    )
  {...}

PROTOCOL_UNBIND_ADAPTER_EX 関数の種類は、Ndis.h ヘッダーファイルで定義されています。コード分析ツールの実行時にエラーをより正確に識別するには、Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations 注釈により、ヘッダーファイル内の PROTOCOL_UNBIND_ADAPTER_EX 関数型に適用される注釈が確実に使用されます。関数宣言の要件の詳細については、「ndis ドライバーのの関数の役割の種類を使用して関数を宣言するを参照してください。

Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	NDIS 6.0 以降でサポートされています。
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ndis.h (Ndis.h を含む)
IRQL	PASSIVE_LEVEL

次の方法で共有

PROTOCOL_UNBIND_ADAPTER_EXコールバック関数 (ndis.h)

構文

パラメーター

戻り値

備考

電源管理と RSS 設定の更新の

の例

必要条件

関連項目

フィードバック

その他のリソース