Udostępnij za pośrednictwem

Polecenia (interfejs API WPD)

  • Artykuł

Aplikacja kliencka i sterownik komunikują się za pomocą poleceń wysyłanych z klienta (za pośrednictwem interfejsu API urządzenia przenośnego systemu Windows) do sterownika (za pośrednictwem User-Mode Driver Framework). Polecenie może lub nie może zawierać parametru i może lub nie zwraca wyniku. Klient może jawnie wysłać polecenie, wywołując metodę IPortableDevice::SendCommand lub metodę IPortableDeviceService:SendCommand lub niejawnie, wywołując dowolną z metod interfejsów klienta. Kilka poleceń można wysyłać tylko jawnie; zostały one zanotowane w dokumentacji polecenia. Strony referencyjne poleceń opisują przeznaczenie polecenia, a także parametry oczekiwane do odebrania oraz parametry, które powinny zostać zwrócone.

Polecenie jest identyfikowane przez PROPERTYKEY struktury. Składa się to z dwóch części: części identyfikatora GUID (fmtid) i części DWORD (składowej pid). Część identyfikatora GUID służy do wskazywania kategorii, do którego należy polecenie (powiązane polecenia należą do tej samej kategorii, dlatego będą miały taką samą fmtid). Część DWORD wskazuje identyfikator polecenia i służy do odróżnienia poszczególnych poleceń w kategorii poleceń (pid wartości dla poleceń w tej samej kategorii będą inne).

W poniższej tabeli wymieniono kategorie poleceń definiowanych przez urządzenia przenośne z systemem Windows. Producenci urządzeń mogą definiować własne polecenia, tworząc własne kategorie poleceń i identyfikatory poleceń. Jednak producent nie powinien dodawać poleceń do kategorii wymienionych poniżej, ponieważ są one zarezerwowane przez firmę Microsoft.

kategorie poleceń

Kategoria poleceń Opis
WPD_CATEGORY_COMMON Polecenia wspólne dla wszystkich obiektów i urządzeń.
WPD_CATEGORY_DEVICE_HINTS Polecenia używane do pobierania opcjonalnych informacji o urządzeniu, które mogą służyć do ulepszania środowiska użytkownika końcowego.
WPD_CATEGORY_SMS Polecenia, które są używane w przypadku urządzeń obsługujących funkcję krótkiej usługi wiadomości (SMS), która jest zwykle widoczna na telefonach komórkowych.
WPD_CATEGORY_STILL_IMAGE_CAPTURE Polecenia używane w przypadku urządzeń, które obsługują przechwytywanie obrazów.
WPD_CATEGORY_STORAGE Polecenia używane do magazynowania obiektów funkcjonalnych.

 

Określone polecenia zdefiniowane dla każdego z tych typów są podane w poniższych tabelach uporządkowane według typu polecenia.

WPD_CATEGORY_COMMON kategorii

Polecenie Opis
WPD_COMMAND_COMMON_RESET_DEVICE Resetuje urządzenie.

 

kategorii WPD_CATEGORY_DEVICE_HINTS

Polecenie Opis
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION Pobiera identyfikatory obiektów folderów, które mogą przechowywać obiekt określonego typu.

 

WPD_CATEGORY_STORAGE kategorii

Polecenie Opis
WPD_COMMAND_STORAGE_EJECT Wyrzuca nośnik pamięci masowej, który może zostać wyrzucony zdalnie przez sterownik.
WPD_COMMAND_STORAGE_FORMAT Formatuje obiekt funkcjonalny magazynu na urządzeniu.

 

kategorii WPD_CATEGORY_SMS

Polecenie Opis
WPD_COMMAND_SMS_SEND Inicjuje wysyłanie wiadomości SMS przez obiekt funkcjonalny SMS.

 

kategorii WPD_CATEGORY_STILL_IMAGE_CAPTURE

Polecenie Opis
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE Inicjuje przechwytywanie obrazu nadal przez obiekt funkcjonalny obrazu.

 

programowania