次の方法で共有

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

必要条件

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

関連項目

ミニポートInitializeEx

NdisIMInitializeDeviceInstanceEx の

NdisMRegisterMiniportDriver の

UNICODE_STRING