命令 (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 | 由仍然影像功能物件起始仍在擷取的影像。 |