Aracılığıyla paylaş

Komutlar (WPD API)

  • Makale

İstemci uygulaması ve sürücü, istemciden (Windows Taşınabilir Cihaz API'si aracılığıyla) sürücüye (User-Mode Driver Framework aracılığıyla) gönderilen komutlar aracılığıyla iletişim kurar. Komut bir parametre içerebilir veya içermeyebilir ve sonuç döndürebilir veya döndürmeyebilir. İstemci, IPortableDevice::SendCommand yöntemini veya IPortableDeviceService:SendCommand yöntemini çağırarak veya örtük olarak istemci arabirimlerinin yöntemlerinden herhangi birini çağırarak açıkça bir komut gönderebilir. Birkaç komut yalnızca açıkça gönderilebilir; bunlar komutun belgelerinde not edilir. Komut başvuru sayfaları, bir komutun amacını ve hangi parametreleri almayı beklediğini ve hangi parametreleri döndürmesinin beklendiğini açıklar.

Komut, PROPERTYKEY yapısıyla tanımlanır. Bu iki bölümden oluşur: GUID bölümü (fmtid üyesi) ve bir DWORD bölümü (pid üyesi). GUID bölümü, komutun ait olduğu kategoriyi belirtmek için kullanılır (ilgili komutlar aynı kategoriye aittir ve bu nedenle aynı fmtid). DWORD bölümü komut kimliğini gösterir ve komut kategorisindeki komutları ayrı ayrı ayırt etmek için kullanılır (aynı kategorideki komutların pid değerleri farklı olacaktır).

Aşağıdaki tabloda, Windows Taşınabilir Cihazlar'ın tanımladığı komut kategorileri listelenmektedir. Cihaz üreticileri kendi komut kategorilerini ve komut kimliklerini oluşturarak kendi komutlarını tanımlayabilir. Ancak, bir üretici aşağıda listelenen kategorilere komut eklememelidir, çünkü bunlar Microsoft tarafından ayrılmıştır.

komut kategorilerini

Komut kategorisi Açıklama
WPD_CATEGORY_COMMON Tüm nesneler ve cihazlar için ortak olan komutlar.
WPD_CATEGORY_DEVICE_HINTS Son kullanıcı deneyimini geliştirmek için kullanılabilecek isteğe bağlı cihaz bilgilerini almak için kullanılan komutlar.
WPD_CATEGORY_SMS Genellikle cep telefonlarında kullanıma sunulan kısa mesaj hizmeti (SMS) işlevselliğini destekleyen cihazlar için kullanılan komutlar.
WPD_CATEGORY_STILL_IMAGE_CAPTURE Hareketsiz görüntü yakalamayı destekleyen cihazlar için kullanılan komutlar.
WPD_CATEGORY_STORAGE Depolama işlev nesneleri için kullanılan komutlar.

 

Bu türlerden her biri için tanımlanan belirli komutlar, komut türüne göre düzenlenmiş olarak aşağıdaki tablolarda verilmiştir.

WPD_CATEGORY_COMMON Kategori

Komut Açıklama
WPD_COMMAND_COMMON_RESET_DEVICE Cihazı sıfırlar.

 

WPD_CATEGORY_DEVICE_HINTS Kategori

Komut Açıklama
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION Belirtilen türde bir nesneyi tutabilen klasörlerin nesne kimliklerini alır.

 

WPD_CATEGORY_STORAGE Kategori

Komut Açıklama
WPD_COMMAND_STORAGE_EJECT Sürücü tarafından uzaktan çıkarılabilen bir depolama ortamı çıkartır.
WPD_COMMAND_STORAGE_FORMAT Cihazdaki depolama işlevsel nesnesini biçimlendirin.

 

WPD_CATEGORY_SMS Kategori

Komut Açıklama
WPD_COMMAND_SMS_SEND SMS işlevsel nesnesi tarafından sms iletisi göndermeyi başlatır.

 

kategori WPD_CATEGORY_STILL_IMAGE_CAPTURE

Komut Açıklama
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE Hareketsiz görüntü işlevsel nesnesi tarafından hareketsiz görüntü yakalama başlatır.

 

Programlama Başvurusu