共用方式為

NdisMIdleNotificationConfirm 函式 （ndis.h）

  • 發行項

迷你埠驅動程式呼叫 NdisMIdleNotificationConfirm，以通知 NDIS 閑置網路適配器可以安全地暫停並轉換為低功率狀態。

迷你埠驅動程式會在 NDIS 選擇性暫停作業期間呼叫此函式。 NDIS 會在呼叫驅動程式的 MiniportIdleNotification 處理程式函式時開始作業。

語法

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

參數

[in] MiniportAdapterHandle

NDIS 傳遞至 MiniportAdapterHandleMiniportInitializeEx的網路適配器句柄。

[in] IdlePowerState

NDIS_DEVICE_POWER_STATE 列舉值，指定網路適配器支援低電源狀態轉換的最低電源狀態。

注意 針對 USB 網路適配器，此參數必須 NdisDeviceStateD2。
 

傳回值

沒有

言論

在 NDIS 呼叫驅動程式 MiniportIdleNotification 函式之後，Miniport 驅動程式會呼叫 NdisMIdleNotificationConfirm。 藉由呼叫 NdisMIdleNotificationConfirm，驅動程式會通知 NDIS 暫停作業可以啟動，而且網路適配器可以轉換為低功率狀態。 在此呼叫中，迷你埠驅動程式會將 IdlePowerState 參數設定為裝置可轉換至的最低電源狀態。

在迷你埠驅動程式呼叫 NdisMIdleNotificationConfirm之前，它必須發出任何可能需要暫停網路適配器的總線特定 I/O 要求封包（IRP）。

例如，當 NDIS 呼叫 MiniportIdleNotification 函式時，USB 迷你埠驅動程式會將 USB 閑置要求 （IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION） 的總線特定 I/O 要求封包 （IRP） 發出至 USB 總線驅動程式。 當 USB 總線驅動程式確認網路適配器可以轉換為低功率狀態時，它會呼叫與 IRP 相關聯的回呼例程。 在回呼例程的內容中，USB 迷你埠驅動程式會呼叫 NdisMIdleNotificationConfirm。 如需詳細資訊，請參閱 實作 USB 閑置要求 IRP 回呼例程。

注意 迷你埠驅動程式不得呼叫 NdisMIdleNotificationConfirm，以取得先前完成的閑置通知。 迷你埠驅動程式會呼叫 NdisMIdleNotificationComplete來完成閑置通知。
 
如需如何處理 NDIS 選擇性暫停閑置通知的詳細資訊，請參閱 處理 NDIS 選擇性暫停閑置通知。

要求

要求 價值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
目標平臺 普遍
標頭 ndis.h （包括 Ndis.h）
連結庫 Ndis.lib
IRQL PASSIVE_LEVEL

另請參閱

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete