DEVICE_RESET_HANDLER回呼函式 （wdm.h）
DeviceReset 例程可用來重設和復原故障的裝置。
語法
DEVICE_RESET_HANDLER DeviceResetHandler;
NTSTATUS DeviceResetHandler(
[in] PVOID InterfaceContext,
[in] DEVICE_RESET_TYPE ResetType,
[in] ULONG Flags,
[in, optional] PVOID ResetParameters
)
{...}
參數
[in] InterfaceContext
介面特定內容資訊的指標。 呼叫端會傳遞做為介面 DEVICE_RESET_INTERFACE_STANDARD 結構之 Context 成員的值。
[in] ResetType
要求的重設類型。 將此參數設定為下列其中一個 DEVICE_RESET_TYPE 列舉值。
FunctionLevelDeviceReset。 指定此值以要求函式層級重設，限制為特定裝置。
PlatformLevelDeviceReset。 指定此值以要求平臺層級重設，這會影響特定裝置，以及透過相同電源軌或重設線路連線到它的其他所有裝置。
如需如何在裝置堆疊中實作函式層級和平臺層級重設的詳細資訊，請參閱 使用 GUID_DEVICE_RESET_INTERFACE_STANDARD。
[in] Flags
設定為 0。 目前，此例程未定義旗標。
[in, optional] ResetParameters
如果呼叫端要求函式層級裝置重設，這個選擇性參數可以指向 FUNCTION_LEVEL_DEVICE_RESET_PARAMETERS 結構，指定重設完成時所呼叫的回呼例程。
傳回值
如果要求的作業成功，此例程會傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS錯誤碼。
言論
如果函式驅動程式偵測到裝置無法正常運作，則應該先嘗試函式層級重設。 如果函式層級重設無法修正此問題，則驅動程式可以嘗試更侵入性的平臺層級重設，但平臺層級重設應該只做為最終選項。
必須在PASSIVE_LEVEL執行函式層級重設或平臺層級重設。
如需函式層級和平台層級重設的詳細資訊，請參閱 使用 GUID_DEVICE_RESET_INTERFACE_STANDARD。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 10 |
| 目標平臺 | 桌面 |
| 標頭 | wdm.h （包括 Wdm.h） |