Share via

命令 (WPD API)

  • 發行項

用戶端應用程式和驅動程式會透過 Windows 可攜式裝置 API 從用戶端 (傳送的命令，) 透過 User-Mode Driver Framework) 傳送至驅動程式 (。 命令可能或可能不會包含參數，而且可能或可能不會傳回結果。 用戶端可以明確傳送命令，方法是呼叫 IPortableDevice：：SendCommand 方法或 IPortableDeviceService：SendCommand 方法，或藉由呼叫用戶端介面的任何方法隱含傳送命令。 一些命令只能明確傳送;這些會記錄在命令的檔中。 命令參考頁面會描述命令的用途，以及其預期接收的參數，以及預期傳回的參數。

命令是由 PROPERTYKEY 結構所識別。 這由兩個部分所組成： (fmtid 成員) 的 GUID 部分，而 DWORD 元件 (pid 成員) 。 GUID 元件用來表示命令所屬的類別 (相關命令屬於相同類別，因此會有相同的 fmtid) 。 DWORD 元件會指出命令識別碼，並用來區分命令類別內的個別命令， (相同類別中命令的 pid 值會不同) 。

下表列出 Windows 可攜式裝置所定義的命令類別。 裝置製造商可以藉由建立自己的命令類別和命令識別碼來定義自己的命令。 不過，製造商不應該將命令新增至下列類別，因為這些命令是由 Microsoft 保留。

命令類別

命令類別目錄 Description
WPD_CATEGORY_COMMON 所有物件和裝置通用的命令。
WPD_CATEGORY_DEVICE_HINTS 用來擷取選擇性裝置資訊的命令，可用來改善使用者體驗。
WPD_CATEGORY_SMS 用於支援簡訊服務的裝置的命令， (SMS) 功能，通常會在行動電話上公開。
WPD_CATEGORY_STILL_IMAGE_CAPTURE 用於支援仍擷取映射之裝置的命令。
WPD_CATEGORY_STORAGE 用於儲存功能物件的命令。

 

下表會提供針對每一種類型所定義的特定命令，並依命令類型組織。

WPD_CATEGORY_COMMON類別

命令 描述
WPD_COMMAND_COMMON_RESET_DEVICE 重設裝置。

 

WPD_CATEGORY_DEVICE_HINTS類別

命令 描述
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 擷取可保存指定型別之物件的資料夾物件識別碼。

 

WPD_CATEGORY_STORAGE類別

命令 描述
WPD_COMMAND_STORAGE_EJECT 退出驅動程式可從遠端退出的儲存媒體。
WPD_COMMAND_STORAGE_FORMAT 格式化裝置上的儲存功能物件。

 

WPD_CATEGORY_SMS類別

命令 描述
WPD_COMMAND_SMS_SEND 起始 SMS 功能物件傳送 SMS 訊息。

 

WPD_CATEGORY_STILL_IMAGE_CAPTURE類別

命令 描述
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE 由仍然影像功能物件起始仍在擷取的影像。

 

程式設計參考