NdisIMCancelInitializeDeviceInstance 函式 (ndis.h)

NdisIMCancelInitializeDeviceInstance 函式會取消先前對 的呼叫 NdisIMInitializeDeviceInstanceEx 函式。

語法

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

參數

[in] DriverHandle

迷你埠驅動程序會處理 NdisMRegisterMiniportDriver 函式在 NdisMiniportDriverHandle 參數傳回。

[in] DeviceInstance

NDIS_STRING型別的指標,描述系統預設字元集中呼叫端初始化的計數位符串。 字串包含登錄機碼的名稱,其中驅動程式會儲存虛擬迷你埠的相關信息,以及可能為系結特定資訊。 對於 windows 2000 和更新版本的驅動程式Microsoft,此字串包含 Unicode 字元。 也就是說,針對 Windows 2000 和更新版本,NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。

傳回值

NdisIMCancelInitializeDeviceInstance 會傳回NDIS_STATUS_SUCCESS,如果取消先前呼叫 NdisIMInitializeDeviceInstanceEx。 否則,如果無法停止虛擬迷你埠的初始化作業,則會傳回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(ndis)

另請參閱

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING