NdisIMCancelInitializeDeviceInstance 函式 (ndis.h)
NdisIMCancelInitializeDeviceInstance 函式會取消先前對 的呼叫 NdisIMInitializeDeviceInstanceEx 函式。
語法
NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
[in] NDIS_HANDLE DriverHandle,
[in] PNDIS_STRING DeviceInstance
);
參數
[in] DriverHandle
迷你埠驅動程序會處理在 NdisMiniportDriverHandle 參數傳回的 NdisMRegisterMiniportDriver 函式。
[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 來取消初始化作業。 例如，如果移除中繼驅動程式針對正常作業所需的基礎驅動程式，中繼驅動程式可以取消與移除的驅動程式相關聯的任何虛擬迷你埠的初始化。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | (支援 NDIS 6.0 和 NDIS 5.1 驅動程式，請參閱 Windows Vista 中的 NdisIMCancelInitializeDeviceInstance (NDIS 5.1) ) 。 (支援 NDIS 5.1 驅動程式，請參閱 Windows XP 中的 NdisIMCancelInitializeDeviceInstance (NDIS 5.1) ) 。 |
| 目標平台 | 桌面 |
| 標頭 | ndis.h (包含 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | Irql_IM_Function () |