NdisMIdleNotificationConfirm 函式 (ndis.h)

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

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

語法

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

參數

[in] MiniportAdapterHandle

NDIS 傳遞給 MiniportInitializeEx 之 MiniportAdapterHandle 參數的網路適配器句柄。

[in] IdlePowerState

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

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

 

傳回值

無

備註

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

在迷你埠驅動程式呼叫 NdisMIdleNotificationConfirm 之前，它必須發出任何總線特定的 I/O 要求封包， (IRP) ，以選擇性地暫停網路適配器。

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

注意 迷你埠驅動程式不得針對先前完成的閑置通知呼叫 NdisMIdleNotificationConfirm 。 迷你埠驅動程式會呼叫 NdisMIdleNotificationComplete 來完成閑置通知。

 

如需如何處理 NDIS 選擇性暫停閑置通知的詳細資訊，請參閱 處理 NDIS 選擇性暫停閑置通知。

規格需求

需求	值
最低支援的用戶端	NDIS 6.30 和更新版本支援。
目標平台	Universal
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL

另請參閱

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete