RegisterDeviceNotificationW 函式 (winuser.h)
註冊視窗將接收通知的裝置或裝置類型。
注意
如果您的程式碼是以 Windows 8 或更新版本的 Windows 為目標，則可以使用CM_Register_Notification，而不是RegisterDeviceNotification。 CM_Register_Notification的優點是不需要視窗控制碼才能運作。
語法
HDEVNOTIFY RegisterDeviceNotificationW(
[in] HANDLE hRecipient,
[in] LPVOID NotificationFilter,
[in] DWORD Flags
);
參數
[in] hRecipient
視窗或服務的控制碼，會接收 NotificationFilter 參數中所指定裝置的裝置事件。 相同的視窗控制碼可用於 對 RegisterDeviceNotification的多個呼叫。
服務可以指定視窗控制碼或服務狀態控制碼。
[in] NotificationFilter
資料區塊的指標，指定應該傳送通知的裝置類型。 此區塊一律以 DEV_BROADCAST_HDR 結構開頭。 此標頭後面的資料取決於 dbch_devicetype 成員的值，可以 DBT_DEVTYP_DEVICEINTERFACE 或 DBT_DEVTYP_HANDLE。 如需詳細資訊，請參閱＜備註＞。
[in] Flags
此參數可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
hRecipient參數是視窗控制碼。 |
|
hRecipient參數是服務狀態控制碼。 |
此外，您可以指定下列值。
| 值 | 意義 |
|---|---|
|
通知所有裝置介面類別別的裝置介面事件的收件者。 (忽略 dbcc_classguid 成員。) 只有當 dbch_devicetype 成員 DBT_DEVTYP_DEVICEINTERFACE時，才能使用這個值。 |
傳回值
如果函式成功，傳回值為裝置通知控制碼。
如果函式失敗，傳回值為 Null。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
應用程式會使用 BroadcastSystemMessage 函式傳送事件通知。 任何具有最上層視窗的應用程式都可以透過處理 WM_DEVICECHANGE 訊息來接收基本通知。 應用程式可以使用 RegisterDeviceNotification 函式來註冊以接收裝置通知。
服務可以使用 RegisterDeviceNotification 函式來註冊以接收裝置通知。 如果服務在 hRecipient 參數中指定視窗控制碼，通知就會傳送至視窗程式。 如果 hRecipient 是服務狀態控制碼， SERVICE_CONTROL_DEVICEEVENT 通知會傳送至服務控制處理常式。 如需服務控制處理常式的詳細資訊，請參閱 HandlerEx。
請務必儘快處理隨插即用裝置事件。 否則，系統可能會變得沒有回應。 如果您的事件處理常式是執行可能會封鎖執行 (的作業，例如 I/O) ，最好啟動另一個執行緒以非同步方式執行作業。
當不再需要時，必須呼叫UnregisterDeviceNotification函式來關閉RegisterDeviceNotification所傳回的裝置通知控制碼。
DBT_DEVICEARRIVAL和DBT_DEVICEREMOVECOMPLETE事件會自動廣播至埠裝置的所有最上層視窗。 因此，不需要呼叫埠的 RegisterDeviceNotification ，而且如果 dbch_devicetype 成員 DBT_DEVTYP_PORT，函式就會失敗。 磁片區通知也會廣播到最上層視窗，因此如果 dbch_devicetype DBT_DEVTYP_VOLUME ，函 式就會失敗。 系統不會直接使用 OEM 定義的裝置，因此如果dbch_devicetype DBT_DEVTYP_OEM，函式就會失敗。
範例
如需範例，請參閱 註冊裝置通知。
注意
winuser.h 標頭會將 RegisterDeviceNotification 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows XP |
| 最低支援的伺服器 | Windows Server 2003 |
| 目標平臺 | Windows |
| 標頭 | winuser.h (包含 Windows.h) |
| 程式庫 | User32.lib |
| DLL | User32.dll |
| API 集合 | ext-ms-win-ntuser-misc-l1-1-0 (在 Windows 8) 中引進 |