Megosztás a következőn keresztül:

Parancsok (WPD API)

  • Cikk

Az ügyfélalkalmazás és az illesztőprogram az ügyféltől (a Windows Portable Device API-n keresztül) az illesztőprogramnak küldött parancsokkal kommunikál (a User-Mode Illesztőprogram-keretrendszeren keresztül). A parancsok tartalmazhatnak vagy nem tartalmazhatnak paramétert, és eredményt adhatnak vagy nem adhatnak vissza. Az ügyfél explicit módon küldhet parancsot az IPortableDevice::SendCommand metódus vagy az IPortableDeviceService:SendCommand metódus meghívásával, vagy implicit módon az ügyfélfelületek bármelyik metódusának meghívásával. Néhány parancs csak explicit módon küldhető el; ezeket a parancs dokumentációjában találja. A parancsok referenciaoldalai ismertetik a parancs célját, valamint azt, hogy milyen paramétereket fog kapni, és milyen paramétereket kell visszaadnia.

A parancsokat egy PROPERTYKEY-struktúra azonosítja. Ez két részből áll: egy GUID-részből (a fmtid tagból) és egy DWORD-részből (a pid tagból). A GUID-rész azt a kategóriát jelzi, amelyhez a parancs tartozik (a kapcsolódó parancsok ugyanahhoz a kategóriához tartoznak, ezért ugyanazzal a fmtid). A DWORD rész a parancsazonosítót jelzi, és a parancskategória egyes parancsainak megkülönböztetésére szolgál (az azonos kategóriában lévő parancsok pid értékei eltérőek lesznek).

Az alábbi táblázat a Windows Portable Devices által definiált parancskategóriákat sorolja fel. Az eszközgyártók saját parancsokat határozhatnak meg saját parancskategóriák és parancsazonosítók létrehozásával. A gyártónak azonban nem szabad parancsokat hozzáadnia az alább felsorolt kategóriákhoz, mivel ezeket a Microsoft fenntartja.

parancskategóriák

Parancskategória Leírás
WPD_CATEGORY_COMMON Az összes objektumra és eszközre jellemző parancsok.
WPD_CATEGORY_DEVICE_HINTS Az opcionális eszközinformációk lekérésére szolgáló parancsok, amelyek a végfelhasználói élmény javítása érdekében használhatók.
WPD_CATEGORY_SMS A rövid üzenetszolgáltatás (SMS) funkcióit támogató eszközökhöz használt parancsok, amelyek általában mobiltelefonokon érhetők el.
WPD_CATEGORY_STILL_IMAGE_CAPTURE Az állókép-rögzítést támogató eszközökhöz használt parancsok.
WPD_CATEGORY_STORAGE A tárolófunkciós objektumokhoz használt parancsok.

 

Az egyes típusokhoz definiált parancsokat a következő táblázatok tartalmazzák, parancstípus szerint rendezve.

WPD_CATEGORY_COMMON kategória

Parancs Leírás
WPD_COMMAND_COMMON_RESET_DEVICE Alaphelyzetbe állítja az eszközt.

 

WPD_CATEGORY_DEVICE_HINTS kategória

Parancs Leírás
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION Lekéri azoknak a mappáknak az objektumazonosítóit, amelyek egy adott típusú objektumot tartalmazhatnak.

 

WPD_CATEGORY_STORAGE kategória

Parancs Leírás
WPD_COMMAND_STORAGE_EJECT Kibocsát egy tárolóeszközt, amelyet az illesztőprogram távolról tud kibocsátani.
WPD_COMMAND_STORAGE_FORMAT Formáz egy tárolófunkciós objektumot az eszközön.

 

WPD_CATEGORY_SMS kategória

Parancs Leírás
WPD_COMMAND_SMS_SEND SMS-üzenet küldését kezdeményezi egy SMS funkcionális objektummal.

 

WPD_CATEGORY_STILL_IMAGE_CAPTURE kategória

Parancs Leírás
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE Állókép-rögzítést kezdeményez egy állókép-funkcionális objektummal.

 

programozási referencia