NdisCloseAdapterEx 関数 (ndis.h)

[アーティクル]
02/26/2024

プロトコルドライバーは NdisCloseAdapterEx 関数を呼び出して、ドライバーが NdisOpenAdapterEx 関数を呼び出したときに割り当てられたバインディングとリソースを解放します。

構文

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

パラメーター

[in] NdisBindingHandle

NdisOpenAdapterEx の NdisBindingHandle パラメーターで NDIS が指定したハンドル。このハンドルは、NDIS が閉じるバインドを識別します。

戻り値

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

リターンコード	説明
NDIS_STATUS_SUCCESS	NdisCloseAdapterEx は、基になるミニポートアダプターへのバインドを正常に閉じました。
NDIS_STATUS_PENDING	NdisCloseAdapterEx は閉じる操作を完了せず、操作は非同期的に完了します。 NDIS はプロトコルドライバーを呼び出します。操作が完了した場合の ProtocolCloseAdapterCompleteEx 関数。

注釈

プロトコルドライバーは通常、 から NdisCloseAdapterEx を 呼び出します。 ProtocolUnbindAdapterEx 関数。ドライバーは、ProtocolBindAdapterEx 関数から NdisCloseAdapterEx を呼び出すこともできます。たとえば、ドライバーが NdisOpenAdapterEx を呼び出した後に OID 値を設定できなかった場合、その ProtocolBindAdapterEx 関数から NdisCloseAdapterExを呼び出すことができます。

プロトコルドライバーが ProtocolUnbindAdapterEx または ProtocolBindAdapterEx のコンテキスト外でミニポートアダプターを閉じる必要がある場合は、NdisUnbindAdapter 関数を呼び出す必要があります。

プロトコルドライバーは、 NdisCloseAdapterEx を呼び出す前に、送信要求と OID 要求が完了するまで待機する必要があります。

ドライバーが NdisCloseAdapterEx を呼び出すとすぐに、NdisBindingHandle パラメーターの NdisOpenAdapterEx 関数から取得されたハンドルが無効になります。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Protocol_Driver_Function(ndis)