NdisIMCancelInitializeDeviceInstance 関数 (ndis.h)

  • [アーティクル]

NdisIMCancelInitializeDeviceInstance 関数は、前の 呼び出しを取り消します。 NdisIMInitializeDeviceInstanceEx 関数。

構文

NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
  [in] NDIS_HANDLE  DriverHandle,
  [in] PNDIS_STRING DeviceInstance
);

パラメーター

[in] DriverHandle

ミニポート ドライバーは、次の処理を処理します。 NdisMRegisterMiniportDriver 関数は、 NdisMiniportDriverHandle パラメーターで返されます。

[in] DeviceInstance

システムの既定の文字セット内の呼び出し元で初期化されたカウントされた文字列を記述するNDIS_STRING型へのポインター。 この文字列には、ドライバーが仮想ミニポートに関する情報と、場合によってはバインディング固有の情報を格納するレジストリ キーの名前が含まれます。 Microsoft Windows 2000 以降のドライバーの場合、この文字列には Unicode 文字が含まれています。 つまり、Windows 2000 以降の場合、NDIS はNDIS_STRING型を UNICODE_STRING 型として定義します。

戻り値

NdisIMCancelInitializeDeviceInstance は、 NdisIMInitializeDeviceInstanceEx の前の呼び出しを取り消した場合、NDIS_STATUS_SUCCESSを返します。 それ以外の場合は、仮想ミニポートの初期化操作を停止する方法がない場合は、NDIS_STATUS_FAILUREを返します。

注釈

中間ドライバーは、 を呼び出します。仮想ミニポートの初期化操作を開始する NdisIMInitializeDeviceInstanceEx 関数。NDIS がドライバーの MiniportInitializeEx 関数を呼び出す前に、ドライバーは NdisIMCancelInitializeDeviceInstance を呼び出して初期化操作を取り消すことができます。 たとえば、中間ドライバーが通常の操作に必要な基になるドライバーを削除した場合、中間ドライバーは、削除されたドライバーに関連付けられているすべての仮想ミニポートの初期化を取り消すことができます。

要件

要件 値
サポートされている最小のクライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisIMCancelInitializeDeviceInstance (NDIS 5.1)」を参照) でサポートされています。 Windows XP での NDIS 5.1 ドライバー (「NdisIMCancelInitializeDeviceInstance (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 Irql_IM_Function(ndis)

こちらもご覧ください

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING