NdisMDeregisterDevice 関数 (ndis.h)

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

NdisMDeregisterDevice 関数は、NdisMRegisterDevice で作成されたデバイス オブジェクトをシステムから削除します。 NdisMDeregisterDevice は、このデバイス オブジェクトに関連付けられているシンボリック リンクも削除します。

構文

NDIS_STATUS NdisMDeregisterDevice(
  [in] NDIS_HANDLE NdisDeviceHandle
);

パラメーター

[in] NdisDeviceHandle

登録解除するデバイス オブジェクトを識別する NdisMRegisterDevice によって返されるハンドルを指定します。

戻り値

NdisMDeregisterDevice は 、デバイス オブジェクトとそれに関連付けられているシンボリック リンク オブジェクトが削除された場合にNDIS_STATUS_SUCCESSを返します。

注釈

ドライバーは、その Halt 関数または Unload 関数から NdisMDeregisterDevice を呼び出して、NdisMRegisterDevice で以前に作成したスタンドアロン デバイス オブジェクトを登録解除します。 ドライバーは、アンロードされている場合、または DriverEntry ルーチンで致命的な初期化エラー (システム リソースを取得できないなど) が発生した場合に NdisMDeregisterDevice を呼び出す必要があります。

NdisMRegisterDevice が呼び出されると、削除されるデバイス オブジェクトに対して未処理のユーザー モードのオープン操作を実行することはできません。 存在する場合は、システム エラーが発生します。

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

要件

こちらもご覧ください

• MiniportHalt
• NdisMRegisterDevice
• NdisMRegisterUnloadHandler