NdisMInitializeWrapper マクロ (ndis.h)

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

NdisMInitializeWrapper は、新しいミニポート ドライバーが初期化中であることを NDIS に通知します。

構文

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

パラメーター

[out] _a

NDIS がそれ自体を表すハンドルを返す呼び出し元が指定した変数へのポインター。 NdisMInitializeWrapper の呼び出しが失敗した場合、NDIS は NdisWrapperHandle の変数を NULL に設定します。

[in] _b

システム固有の型のポインターを指定します。

Windows 2000 以降のドライバーの場合、これはミニポート ドライバーの DriverEntry 関数への不透明なドライバー オブジェクト入力へのポインターです。

[in] _c

システム固有の型のポインターを指定します。

Windows 2000 以降のドライバーの場合、これはミニポート ドライバーの DriverEntry 関数への不透明なレジストリ パス入力へのポインターです。

[in] _d

システム固有の型のポインターを指定します。

Windows 2000 以降のドライバーの場合、ミニポート ドライバーが NdisMInitializeWrapper を呼び出すときに、このポインターを NULL に設定する必要があります。

戻り値

なし

解説

NIC ドライバーまたは中間ドライバーは、他の NdisXxx 関数を呼び出す前に NdisMInitializeWrapper を呼び出す必要があります。 通常、この呼び出しは、NIC ドライバーの DriverEntry 関数の初期アクションであり、次に返された NdisWrapperHandle を使用して NdisMRegisterMiniport または NdisIMRegisterLayeredMiniport を呼び出します。 また、NDIS 中間ドライバーは、DriverEntry 関数から NdisMInitializeWrapper を呼び出し、返された NdisWrapperHandle を使用して NdisMRegisterMiniport または NdisIMRegisterLayeredMiniport を呼び出す必要があります。

このようなドライバーの後続の NdisXxx 初期化および構成関数の呼び出しでは、 NdisWrapperHandle をパラメーターとして渡す必要があります。 その結果、 ミニポート初期化 関数への入力パラメーターです。

NdisMInitializeWrapper の呼び出しが失敗した場合、NDIS は NdisWrapperHandle の変数を NULL に設定します。 NdisMInitializeWrapper が返された後、ドライバーは常にこの変数の値をチェックする必要があります。 値が NULL の場合、ドライバーは DriverEntry 関数の呼び出しに失敗する必要があります。

要件

こちらもご覧ください

ミニポート ドライバーの初期化

NdisMRegisterMiniport

MiniportInitialize

NdisIMRegisterLayeredMiniport

NdisTerminateWrapper