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) |