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

[アーティクル]
02/29/2024

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