NdisCloseAdapter 関数 (ndis.h)

メモ NDIS 5。 x は非推奨となり、NDIS 6 に置き換えられます。 x があります。 新しい NDIS ドライバーの開発については、「 Windows Vista 以降のネットワーク ドライバー」を参照してください。 NDIS 5 の移植について説明します。 x ドライバーを NDIS 6 に設定します。 x については、「 NDIS 5.x ドライバーを NDIS 6.0 に移植する」を参照してください。

NdisCloseAdapter は 、確立されたバインディングと、 NdisOpenAdapter と呼ばれるプロトコル時に割り当てられたリソースを解放します。

構文

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

パラメーター

[out] Status

この関数が閉じる操作の状態を返す呼び出し元が指定した変数へのポインター。次のいずれかの値を指定できます。

• NDIS_STATUS_SUCCESS
  バインディングが閉じられ、そのバインディングに関連するすべてのリソースが解放されました。

• NDIS_STATUS_PENDING
  close-adapter 要求は非同期的に処理されており、閉じる操作が完了すると、呼び出し元の ProtocolCloseAdapterComplete 関数が呼び出されます。

[in] NdisBindingHandle

閉じる仮想アダプターまたは NIC を識別する NdisOpenAdapter によって返されるハンドルを指定します。

戻り値

なし

解説

戻り値: なし

プロトコル ドライバーは通常、ProtocolUnbindAdapter 関数から NdisCloseAdapter を呼び出します。 また、バインドを設定するために NdisOpenAdapter を呼び出した後に OID 値を設定できなかった場合など、 ProtocolBindAdapter 関数から NdisCloseAdapter を呼び出すこともできます。

プロトコルで NdisCloseAdapter が呼び出されるとすぐに、 NdisBindingHandle のハンドルは呼び出し元によって無効と見なされます。 NdisXxx 関数の後続の呼び出しでこのハンドルを渡すプログラミング エラーです。

• ターゲット プラットフォーム: ユニバーサル
• バージョン: Windows Vista の NDIS 6.0 ドライバーではサポートされていません。 代わりに NdisCloseAdapterEx を使用してください。 Windows Vista および Windows XP の NDIS 5.1 ドライバーでサポートされています。

要件

こちらもご覧ください

• NdisCompleteUnbindAdapter
• NdisOpenAdapter
• ProtocolCloseAdapterComplete
• ProtocolUnbindAdapter