Delen via


Opdrachten (WPD API)

De clienttoepassing en het stuurprogramma communiceren via opdrachten die worden verzonden van de client (via de Windows Portable Device API) naar het stuurprogramma (via het User-Mode Driver Framework). Een opdracht bevat al dan niet een parameter en retourneert wel of niet een resultaat. Een client kan expliciet een opdracht verzenden door de methode IPortableDevice::SendCommand methode of de methode IPortableDeviceService:SendCommand aan te roepen, of impliciet door een van de methoden van de clientinterfaces aan te roepen. Een paar opdrachten kunnen alleen expliciet worden verzonden; deze worden vermeld in de documentatie van de opdracht. De opdrachtreferentiepagina's beschrijven het doel van een opdracht, evenals de parameters die worden verwacht te ontvangen en welke parameters worden verwacht om te retourneren.

Een opdracht wordt geïdentificeerd door een PROPERTYKEY structuur. Dit bestaat uit twee delen: een GUID-onderdeel (het fmtid lid) en een DWORD-deel (het pid lid). Het GUID-onderdeel wordt gebruikt om de categorie aan te geven waartoe de opdracht behoort (gerelateerde opdrachten behoren tot dezelfde categorie en hebben daarom dezelfde fmtid). Het DWORD-onderdeel geeft de opdracht-id aan en wordt gebruikt om de afzonderlijke opdrachten in een opdrachtcategorie te onderscheiden (de pid waarden voor opdrachten in dezelfde categorie zijn anders).

De volgende tabel bevat de categorieën opdrachten die door Windows Portable Devices worden gedefinieerd. Apparaatfabrikanten kunnen hun eigen opdrachten definiëren door hun eigen opdrachtcategorieën en opdracht-id's te maken. Een fabrikant mag echter geen opdrachten toevoegen aan de categorieën die hieronder worden vermeld, omdat deze door Microsoft zijn gereserveerd.

opdrachtcategorieën

Opdrachtcategorie Beschrijving
WPD_CATEGORY_COMMON Opdrachten die gebruikelijk zijn voor alle objecten en apparaten.
WPD_CATEGORY_DEVICE_HINTS Opdrachten die worden gebruikt om optionele apparaatgegevens op te halen die kunnen worden gebruikt om de eindgebruikerservaring te verbeteren.
WPD_CATEGORY_SMS Opdrachten die worden gebruikt voor apparaten die ondersteuning bieden voor de functionaliteit van de korte berichtenservice (SMS), die doorgaans beschikbaar is op mobiele telefoons.
WPD_CATEGORY_STILL_IMAGE_CAPTURE Opdrachten die worden gebruikt voor apparaten die nog steeds installatiekopieën vastleggen ondersteunen.
WPD_CATEGORY_STORAGE Opdrachten die worden gebruikt voor functionele opslagobjecten.

 

De specifieke opdrachten die voor elk van deze typen zijn gedefinieerd, worden gegeven in de volgende tabellen, geordend op opdrachttype.

WPD_CATEGORY_COMMON categorie

Bevelen Beschrijving
WPD_COMMAND_COMMON_RESET_DEVICE Hiermee stelt u het apparaat opnieuw in.

 

WPD_CATEGORY_DEVICE_HINTS categorie

Bevelen Beschrijving
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION Hiermee worden de object-id's opgehaald van mappen die een object van een opgegeven type kunnen bevatten.

 

WPD_CATEGORY_STORAGE categorie

Bevelen Beschrijving
WPD_COMMAND_STORAGE_EJECT Hiermee wordt een opslagmedium uitgetrokken dat extern door het stuurprogramma kan worden uitgeworpen.
WPD_COMMAND_STORAGE_FORMAT Hiermee wordt een functioneel opslagobject op het apparaat opgemaakt.

 

WPD_CATEGORY_SMS categorie

Bevelen Beschrijving
WPD_COMMAND_SMS_SEND Hiermee start u het verzenden van een SMS-bericht door een functioneel SMS-object.

 

WPD_CATEGORY_STILL_IMAGE_CAPTURE categorie

Bevelen Beschrijving
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE Hiermee wordt een still image capture gestart door een nog functioneel object voor afbeeldingen.

 

Programmeringsreferentie