Sdílet prostřednictvím

Příkazy (ROZHRANÍ API WPD)

  • Článek

Klientská aplikace a ovladač komunikují pomocí příkazů odesílaných z klienta (prostřednictvím rozhraní API pro přenosné zařízení systému Windows) k ovladači (prostřednictvím rozhraní User-Mode Driver Framework). Příkaz může nebo nemusí obsahovat parametr a může nebo nemusí vrátit výsledek. Klient může příkaz odeslat explicitně voláním IPortableDevice::SendCommand metoda nebo IPortableDeviceService:SendCommand metoda, nebo implicitně voláním jakékoli metody rozhraní klienta. Několik příkazů lze odeslat pouze explicitně; jsou uvedeny v dokumentaci k příkazu. Referenční stránky příkazů popisují účel příkazu a také parametry, které očekává přijetí a jaké parametry se mají vrátit.

Příkaz je identifikován strukturou PROPERTYKEY. Skládá se ze dvou částí: část GUID (fmtid člen) a část DWORD (pid člen). Část GUID slouží k označení kategorie, do které příkaz patří (související příkazy patří do stejné kategorie, a proto budou mít stejný fmtid). Část DWORD označuje ID příkazu a slouží k rozlišení jednotlivých příkazů v kategorii příkazů (pid hodnoty pro příkazy ve stejné kategorii se budou lišit).

V následující tabulce jsou uvedeny kategorie příkazů, které definuje přenosná zařízení s Windows. Výrobci zařízení můžou definovat vlastní příkazy vytvořením vlastních kategorií příkazů a ID příkazů. Výrobce by ale neměl přidávat příkazy do níže uvedených kategorií, protože tyto příkazy jsou vyhrazeny společností Microsoft.

kategorie příkazů

Kategorie příkazů Popis
WPD_CATEGORY_COMMON Příkazy, které jsou společné pro všechny objekty a zařízení
WPD_CATEGORY_DEVICE_HINTS Příkazy, které slouží k načtení volitelných informací o zařízeních, které je možné použít ke zlepšení uživatelského prostředí.
WPD_CATEGORY_SMS Příkazy používané pro zařízení, která podporují funkci krátké služby zpráv (SMS), která je obvykle vystavená na mobilních telefonech.
WPD_CATEGORY_STILL_IMAGE_CAPTURE Příkazy používané pro zařízení, která podporují zachytávání imagí.
WPD_CATEGORY_STORAGE Příkazy, které se používají pro funkční objekty úložiště.

 

Konkrétní příkazy definované pro každý z těchto typů jsou uvedeny v následujících tabulkách uspořádaných podle typu příkazu.

WPD_CATEGORY_COMMON kategorie

Příkaz Popis
WPD_COMMAND_COMMON_RESET_DEVICE Obnoví zařízení.

 

kategorie WPD_CATEGORY_DEVICE_HINTS

Příkaz Popis
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION Načte ID objektů složek, které mohou obsahovat objekt zadaného typu.

 

WPD_CATEGORY_STORAGE kategorie

Příkaz Popis
WPD_COMMAND_STORAGE_EJECT Vysune úložné médium, které může ovladač vzdáleně vysunout.
WPD_COMMAND_STORAGE_FORMAT Naformátuje funkční objekt úložiště na zařízení.

 

kategorie WPD_CATEGORY_SMS

Příkaz Popis
WPD_COMMAND_SMS_SEND Zahájí odesílání zprávy SMS funkčním objektem SMS.

 

kategorie WPD_CATEGORY_STILL_IMAGE_CAPTURE

Příkaz Popis
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE Inicializuje zachytávání obrazu stále funkčním objektem image.

 

Referenčníprogramování