Dela via

Kommandon (WPD API)

  • Artikel

Klientprogrammet och drivrutinen kommunicerar med hjälp av kommandon som skickas från klienten (via WINDOWS Portable Device API) till drivrutinen (via User-Mode Driver Framework). Ett kommando kanske eller kanske inte innehåller en parameter och kanske inte returnerar ett resultat. En klient kan skicka ett kommando explicit genom att anropa antingen metoden IPortableDevice::SendCommand eller metoden IPortableDeviceService:SendCommand eller implicit genom att anropa någon av metoderna i klientgränssnitten. Ett fåtal kommandon kan bara skickas explicit. dessa anges i kommandots dokumentation. Kommandoreferenssidorna beskriver syftet med ett kommando, samt vilka parametrar det förväntar sig att ta emot och vilka parametrar som förväntas returneras.

Ett kommando identifieras av en PROPERTYKEY- struktur. Detta består av två delar: en GUID-del (fmtid medlem) och en DWORD-del (pid medlem). GUID-delen används för att ange vilken kategori kommandot tillhör (relaterade kommandon tillhör samma kategori och har därför samma fmtid). DWORD-delen anger kommando-ID och används för att särskilja de enskilda kommandona inom en kommandokategori (pid värden för kommandon i samma kategori kommer att vara olika).

I följande tabell visas de kategorier av kommandon som Windows Portable Devices definierar. Enhetstillverkare kan definiera sina egna kommandon genom att skapa egna kommandokategorier och kommando-ID:n. En tillverkare bör dock inte lägga till kommandon i kategorierna nedan, eftersom de är reserverade av Microsoft.

kommandokategorier

Kommandokategori Beskrivning
WPD_CATEGORY_COMMON Kommandon som är gemensamma för alla objekt och enheter.
WPD_CATEGORY_DEVICE_HINTS Kommandon som används för att hämta valfri enhetsinformation som kan användas för att förbättra slutanvändarupplevelsen.
WPD_CATEGORY_SMS Kommandon som används för enheter som stöder sms-funktioner (Short Message Service), som vanligtvis exponeras på mobiltelefoner.
WPD_CATEGORY_STILL_IMAGE_CAPTURE Kommandon som används för enheter som stöder stillbildstagning.
WPD_CATEGORY_STORAGE Kommandon som används för lagringsfunktionella objekt.

 

De specifika kommandon som definieras för var och en av dessa typer anges i följande tabeller, ordnade efter kommandotyp.

WPD_CATEGORY_COMMON kategori

Befallning Beskrivning
WPD_COMMAND_COMMON_RESET_DEVICE Återställer enheten.

 

WPD_CATEGORY_DEVICE_HINTS kategori

Befallning Beskrivning
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION Hämtar objekt-ID:t för mappar som kan innehålla ett objekt av en angiven typ.

 

WPD_CATEGORY_STORAGE kategori

Befallning Beskrivning
WPD_COMMAND_STORAGE_EJECT Matar ut ett lagringsmedium som kan matas ut via fjärranslutning av drivrutinen.
WPD_COMMAND_STORAGE_FORMAT Formaterar ett funktionsobjekt för lagring på enheten.

 

WPD_CATEGORY_SMS kategori

Befallning Beskrivning
WPD_COMMAND_SMS_SEND Initierar sändning av ett SMS-meddelande av ett funktionellt SMS-objekt.

 

WPD_CATEGORY_STILL_IMAGE_CAPTURE kategori

Befallning Beskrivning
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE Initierar en stillbildsinspelning av ett funktionsobjekt för stillbilder.

 

programmeringsreferens