次の方法で共有


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

NDIS は、ミニポート ドライバーのミニポートDevicePnPEventNotify 関数を呼び出して、プラグ アンド プレイ (PnP) イベントをドライバーに通知します。

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

構文

MINIPORT_DEVICE_PNP_EVENT_NOTIFY MiniportDevicePnpEventNotify;

void MiniportDevicePnpEventNotify(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNET_DEVICE_PNP_EVENT NetDevicePnPEvent
)
{...}

パラメーター

[in] MiniportAdapterContext

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

[in] NetDevicePnPEvent

デバイス プラグ アンド プレイ イベントを記述するNET_DEVICE_PNP_EVENT構造体へのポインター。

戻り値

なし

解説

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

NDIS は、次のいずれかのイベントの後に NdisDevicePnPEventPowerProfileChanged に設定された NetDevicePnPEvent パラメーターの DevicePnPEvent メンバーを使用して、ドライバーのミニポートDevicePnPEventNotify 関数を呼び出します。

  • ドライバーの初期化が完了しました。
  • ドライバーは、電源オン状態 (NdisDeviceStateD0) を指定するOID_PNP_SET_POWER通知を受け取った。
2 番目の場合、 InformationBuffer の値は、システムがバッテリ電源 (NdisPowerProfileBattery) または AC 電源 (NdisPowerProfileAcOnline) で実行されているかどうかを示します。 ドライバーは、この情報を使用して、指定されたミニポート アダプターの電力消費量を調整できます。 たとえば、ワイヤレス LAN デバイスのドライバーは、システムがバッテリ電源で実行されている場合は電力消費量を削減し、システムが AC 電源で実行されている場合は電力消費量を増やします。

ドライバーが突然の削除通知を受け取ると (NetDevicePnPEvent パラメーターの DevicePnPEvent メンバーは NdisDevicePnPEventSurpriseRemoved)、次の操作を行う必要があります。

  • 内部的には、デバイスが削除されていることに注意してください。
  • 基になるバス ドライバーに送信された保留中の IRP をすべて取り消します。
NDIS が ミニポートDevicePnPEventNotify 関数を呼び出して突然の削除を示した後、NDIS はドライバーの MiniportHaltEx 関数を呼び出します。 NDIS が MiniportHaltEx を呼び出す前に、ドライバーが送信要求または OID 要求を受信した場合は、状態値が NDIS_STATUS_NOT_ACCEPTED ですぐにこのような要求を完了する必要があります。

NDIS は、IRQL = PASSIVE_LEVELで MiniportDevicePnPEventNotify を呼び出します。

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

たとえば、" MyDevicePnPEventNotify" という名前の MiniportDevicePnPEventNotify 関数を定義するには、次のコード例に示すように 、MINIPORT_DEVICE_PNP_EVENT_NOTIFY 型を使用します。

MINIPORT_DEVICE_PNP_EVENT_NOTIFY MyDevicePnPEventNotify;

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

_Use_decl_annotations_
VOID
 MyDevicePnPEventNotify(
    NDIS_HANDLE  MiniportAdapterContext,
    PNET_DEVICE_PNP_EVENT  NetDevicePnPEvent
    )
  {...}

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

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

要件

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

こちらもご覧ください

MiniportHaltEx

MiniportInitializeEx

NET_DEVICE_PNP_EVENT

NdisMRegisterMiniportDriver

OID_PNP_SET_POWER