次の方法で共有

NdisIMNotifyPnPEvent 関数 (ndis.h)

  • [アーティクル]

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

NdisIMNotifyPnPEvent は、プラグ アンド プレイまたは電源管理イベントの通知を、基になるドライバーに伝達します。

構文

NDIS_STATUS NdisIMNotifyPnPEvent(
  [in] NDIS_HANDLE    MiniportHandle,
  [in] PNET_PNP_EVENT NetPnPEvent
);

パラメーター

[in] MiniportHandle

ミニポート初期化をするハンドル入力。 このハンドルは、呼び出し元の ProtocolPnPEvent 関数に渡されるプラグ アンド プレイまたは電源管理イベントの影響を受けるミニポート ドライバーを表します。

[in] NetPnPEvent

プロトコル ドライバーに示されているプラグ アンド プレイ イベントまたは Power Management イベントを記述するNET_PNP_EVENT構造体へのポインター。

戻り値

NdisIMNotifyPnPEvent は、次のいずれかを返すことができます。

リターン コード 形容
NDIS_STATUS_SUCCESS 上にあるドライバーが正常に伝達されたプラグ アンド プレイ イベントが成功しました。
NDIS_STATUS_FAILURE 上にあるドライバーが、伝達されたプラグ アンド プレイ イベントに失敗しました。

戻り値は、伝達されたイベントが NetEventQueryPower または NetEventQueryRemoveである場合にのみ有効です。 他のすべての伝達イベントでは、戻り値は常にNDIS_STATUS_SUCCESS。

備考

NDIS 中間ドライバーは、ドライバーの ProtocolPnPEvent 関数のコンテキストで NdisIMNotifyPnPEvent を呼び出して、プラグ アンド プレイまたは電源管理イベントの通知を基になるドライバーに伝達します。

伝達されるイベントが NetEventQueryPower または NetEventQueryRemoveである場合、中間ドライバーは NdisIMNotifyPnPEvent によって返されるNDIS_STATUS値確認する必要があります。 返された状態がNDIS_STATUS_SUCCESS場合、中間ドライバーは、通常どおりに内部的にイベントを処理し、その ProtocolPnPEvent 関数からNDIS_STATUS_SUCCESSを返す必要があります。 返された状態がNDIS_STATUS_FAILURE場合、中間ドライバーは、それ以上の処理を行わずに、ProtocolPnPEvent からNDIS_STATUS_FAILUREを返す必要があります。

他のすべての伝達イベントについて、NdisIMNotifyPnPEvent は常にNDIS_STATUS_SUCCESSを返します。 このような場合、中間ドライバーの ProtocolPnPEvent 関数は、NdisIMNotifyPnPEvent によって返されるNDIS_STATUS伝達する必要があります。

中間ドライバーが、ProtocolPnPEvent 関数によって受信した NetEventSetPower を処理する方法は、指定されたデバイスの電源状態によって異なります。 指定したデバイスの電源状態が NdisDeviceStateD0 場合、中間ドライバーは通常どおりにイベントを内部的に処理し、NdisIMNotifyPnPEvent 呼び出す必要があります。 その他の指定されたデバイスの電源状態の場合、中間ドライバーは最初に NdisIMNotifyPnPEvent 呼び出し、通常どおりに内部的にイベントを処理する必要があります。

中間ドライバーは、NetEventReconfigure または NetEventBindList を伝達するために、NdisIMNotifyPnPEvent を呼び出す必要があります。これは、NetEventReconfigure または NetEventBindList が非NULLProtocolBindingContextに示されている場合のみです。 NetEventReconfigure または NetEventBindList が NULLProtocolBindingContextで示されている場合、中間ドライバーは NdisIMNotifyPnPEvent 呼び出してイベントを伝達しないでください。

中間ドライバーが NetEventReconfigure または NetEventBindListを処理する場合は、イベントに関連付けられているデータを検証する必要があります。 (このようなデータの詳細については、「プロトコル ドライバーのNET_PNP_EVENT」を参照してください)。

NdisIMNotifyPnPEvent のシステム サポートは、Windows XP 以降のバージョンで利用できます。

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

必要条件

要件 価値
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL PASSIVE_LEVEL

関連項目