共用方式為

指令 （WPD API）

  • 發行項

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

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

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

命令類別目錄

命令類別 描述
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功能對象傳送簡訊訊息。

 

WPD_CATEGORY_STILL_IMAGE_CAPTURE 類別

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

 

程式設計參考