RegisterDeviceNotificationW 函式 (winuser.h)

發行項
03/11/2023

註冊視窗將接收通知的裝置或裝置類型。

注意

如果您的程式碼是以 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

此參數可以是下列其中一個值。

值	意義
DEVICE_NOTIFY_WINDOW_HANDLE 0x00000000	hRecipient參數是視窗控制碼。
DEVICE_NOTIFY_SERVICE_HANDLE 0x00000001	hRecipient參數是服務狀態控制碼。

此外，您可以指定下列值。

值	意義
DEVICE_NOTIFY_ALL_INTERFACE_CLASSES 0x00000004	通知所有裝置介面類別別的裝置介面事件的收件者。 (忽略 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) 中引進