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

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

NDIS ミニポートアダプターが削除されたときにリソースを解放し、ハードウェアを停止するミニポートドライバーの ミニポートHaltEx 関数を呼び出します。この関数は、ミニポートを停止状態にし、他のコールバックは発生できません (ミニポートShutdownEx 含む)。ミニポートドライバーの状態の詳細については、「ミニポートアダプターの状態と操作を参照してください。

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

構文

MINIPORT_HALT MiniportHalt;

void MiniportHalt(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] NDIS_HALT_ACTION HaltAction
)
{...}

パラメーター

[in] MiniportAdapterContext

ミニポートドライバーがそのミニポートInitializeEx 関数に割り当てられたコンテキスト領域へのハンドル。ミニポートドライバーは、ミニポートアダプターの状態情報を維持するには、このコンテキスト領域を使用します。

[in] HaltAction

ミニポートアダプターを停止する理由。次のいずれかの値を指定できます。

NdisHaltDeviceDisabled

NDIS は、プラグアンドプレイ (PnP) の削除メッセージに応答してミニポートアダプターを停止しています。

NdisHaltDeviceInstanceDeInitialized

NDIS は、中間ドライバーの呼び出しに応答してミニポートアダプターを停止しています。NdisIMDeInitializeDeviceInstance 関数をします。

NdisHaltDevicePoweredDown

NDIS は、システムがスリープ状態になるため、ミニポートアダプターを停止しています。

NdisHaltDeviceSurpriseRemoved

ミニポートアダプターが突然削除され、ハードウェアが存在しません。

NdisHaltDeviceFailed

ハードウェア障害が原因でミニポートアダプターが削除されています。 ndisMRemoveMiniport 関数呼び出されたミニポートドライバーか、バスドライバーが再開時に NIC の電源をオンにしませんでした。

NdisHaltDeviceInitializationFailed

NDIS が正常に完了したミニポートInitializeEx 関数が正常に完了した後、不明な理由でミニポートアダプターを初期化できませんでした。

NdisHaltDeviceStopped

NDIS は、PnP 停止デバイスメッセージに応答してミニポートアダプターを停止しています。

戻り値

何一つ

備考

ドライバーは、ミニポートHaltEx エントリポイントを呼び出すときに指定します。NdisMRegisterMiniportDriver 関数をします。

NDIS は、ドライバーのミニポートInitializeEx 関数が正常に返された後、いつでもミニポートHaltEx を呼び出すことができます。ドライバーが物理 NIC を制御する場合は、ミニポートHaltEx NIC を停止する必要があります。 NDIS 中間ドライバーを呼び出す場合は、NdisIMDeInitializeDeviceInstance 関数、NDIS はドライバーの仮想デバイスの ミニポートHaltEx 関数を呼び出します。

ミニポートHaltEx は、デバイスのミニポートInitializeEx 割り当てられたすべてのリソースを解放する必要があります。 ミニポートHaltEx は、そのデバイスの後続の操作でドライバーが割り当てたその他のリソースも解放します。ドライバーは、最初にリソースを割り当てた NdisXxx 関数の逆数を呼び出す必要があります。一般的な規則として、ミニポートHaltEx 関数は、ミニポートInitializeEx から行われたドライバーの呼び出しに逆順に逆の逆 NdisXxx 関数呼び出す必要があります。

NIC が割り込みを生成する場合、ミニポートドライバーの ミニポートHaltEx 関数は、ドライバーのミニポートInterrupt 関数によって取り込まれる可能性 ミニポートHaltEx 呼び出しまでNdisMDeregisterInterruptEx 関数が返。このようなドライバーの ミニポートHaltEx 関数は割り込みを無効にし、呼び出す必要がありますNdisMDeregisterInterruptEx できるだけ早く。ドライバーは、次の時間まで割り込みを受け続けることができることに注意してください。NdisMDeregisterInterruptEx 戻。 NdisMDeregisterInterruptEx は、ドライバーがスケジュールされたすべての DPC を終了するまで戻りません (詳細については、ミニポートInterruptDPC 関数を参照してください)。

システムタイマーキュー内にある可能性があるタイマーオブジェクトに関連付けられている NetTimerCallback 関数がドライバーにある場合は、ミニポートHaltEx は、NdisCancelTimerObject 関数を呼び出す必要があります。 NdisCancelTimerObject 失敗した場合、タイマーは既に発生している可能性があります。この場合、ドライバーは、ミニポートHaltEx からドライバーが戻る前に、タイマー関数が完了待機する必要があります。

未処理の OID 要求がある場合、または要求を送信 場合、NDIS はミニポートHaltEx を呼び出しません。 NDIS は、ミニポートHaltEx を呼び出した後、影響を受けるデバイスそれ以上の要求を送信しません。

ドライバーが任意の操作が完了するまで待機する必要がある場合は、ミニポートHaltEx は、NdisWaitEvent 関数または NdisMSleep 関数を使用できます。

NDIS は IRQL = PASSIVE_LEVEL でミニポートHaltEx 呼び出します。

の例

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

たとえば、"MyHaltEx" という名前の ミニポートHaltEx 関数を定義するには、次のコード例に示すように MINIPORT_HALT 型を使用します。

MINIPORT_HALT MyHaltEx;

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

_Use_decl_annotations_
VOID
 MyHaltEx(
    NDIS_HANDLE  MiniportAdapterContext,
    NDIS_HALT_ACTION  HaltAction
    )
  {...}

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

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

必要条件

要件	価値
サポートされる最小クライアント	NDIS 6.0 以降でサポートされています。
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ndis.h (Ndis.h を含む)
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	WlanAssociation、WlanConnectionRoaming、WlanDisassociation、WlanTimedAssociation、WlanTimedConnectionRoaming、WlanTimedConnectRequest、WlanTimedLinkQuality、WlanTimedScan

次の方法で共有