Delen via

Ondersteuning voor compatibiliteitsopdrachten (voorbeeld van WpdServiceSampleDriver)

  • Artikel

Het voorbeeldstuurprogramma ondersteunt tien mogelijkheidsopdrachten voor een apparaat en 14 mogelijkheidsopdrachten voor een service. De code die ondersteuning biedt voor de opdrachten voor apparaatmogelijkheden vindt u in WpdCapabilities.cpp. De code die de opdrachten voor servicemogelijkheden ondersteunt, vindt u in WpdServiceCapabilities.cpp. WPD roept deze opdrachten aan wanneer een toepassing apparaat- of servicemogelijkheidsgegevens ophaalt. Wanneer een toepassing bijvoorbeeld IPortableDeviceServiceCapabilities aanroept::GetSupportedFormats, geeft WPD een bijbehorende WPD_COMMAND_SERVICE_CAPABILITIES_GET_SUPPORTED_FORMATS opdracht uit aan het stuurprogramma om de ondersteunde indelingen voor een bepaalde service op te halen.

De Device-Capability-opdrachten

De opdrachten voor apparaatfunctionaliteit worden uitgegeven wanneer een toepassing een van de verschillende methoden aanroept in de IPortableDeviceCapabilities interface. Deze opdrachten worden in eerste instantie verwerkt door de WpdCapabilities::D ispatchMessage methode die op zijn beurt een bijbehorende opdrachthandler aanroept. De methode DispatchMessage en de afzonderlijke handlers vindt u in het bestand WpdCapabilities.cpp. In de volgende tabel worden alle opdrachten voor apparaatfunctionaliteit beschreven, samen met de namen van de handlers die DispatchMessage aanroept wanneer een bepaalde opdracht wordt verwerkt.

Bevelen Handler Beschrijving
WPD_COMMAND_CAPABILITIES_GET_SUPPORTED_COMMANDS OnGetSupportedCommands Uitgegeven wanneer een toepassing probeert de set opdrachten op te halen die door het apparaat worden ondersteund.
WPD_COMMAND_CAPABILITIES_GET_COMMAND_OPTIONS OnGetCommandOptions Uitgegeven wanneer een toepassing probeert de opties op te halen die worden ondersteund door een bepaalde opdracht.
WPD_COMMAND_CAPABILITIES_GET_SUPPORTED_FUNCTIONAL_CATEGORIES OnGetFunctionalCategories Uitgegeven wanneer een toepassing probeert de set functionele categorieën op te halen die door het apparaat worden ondersteund.
WPD_COMMAND_CAPABILITIES_GET_FUNCTIONAL_OBJECTS OnGetFunctionalObjects Uitgegeven wanneer een toepassing probeert de set functionele objecten op te halen die worden ondersteund door een bepaalde functionele categorie.
WPD_COMMAND_CAPABILITIES_GET_SUPPORTED_CONTENT_TYPES OnGetSupportedContentTypes Uitgegeven wanneer een toepassing probeert de inhoudstypen op te halen die worden ondersteund door een bepaalde functionele categorie.
WPD_COMMAND_CAPABILITIES_GET_SUPPORTED_FORMATS OnGetSupportedFormats Uitgegeven wanneer een toepassing probeert de set indelingen op te halen die worden ondersteund door een bepaald inhoudstype.
WPD_COMMAND_CAPABILITIES_GET_SUPPORTED_FORMAT_PROPERTIES OnGetSupportedFormatProperties Uitgegeven wanneer een toepassing probeert de set eigenschappen op te halen die worden ondersteund door een bepaalde indeling.
WPD_COMMAND_CAPABILITIES_GET_FIXED_PROPERTY_ATTRIBUTES OnGetFixedPropertyAttributes Uitgegeven wanneer een toepassing probeert de set eigenschapskenmerken op te halen die identiek (of vast) zijn voor alle objecten van een bepaalde indeling.
WPD_OPDRACHT_CAPACITEITEN_HAAL_GEBEURTENISOPTIES_OP OnGetEventOptions Uitgegeven wanneer een toepassing probeert de opties op te halen die zijn gekoppeld aan een bepaalde gebeurtenis.
WPD_COMMAND_CAPABILITIES_GET_SUPPORTED_EVENTS OnGetSupportedEvents Uitgegeven wanneer een toepassing probeert de set gebeurtenissen op te halen die door een apparaat worden ondersteund.

De Service-Capability-opdrachten

De opdrachten voor servicemogelijkheden worden uitgegeven wanneer een toepassing een van de verschillende methoden aanroept in de interface IPortableDeviceServiceCapabilities. Deze opdrachten worden in eerste instantie verwerkt door de WpdServiceCapabilities::D ispatchMessage methode die op zijn beurt een bijbehorende opdrachthandler aanroept. De methode DispatchMessage en de afzonderlijke handlers vindt u in het bestand WpdServiceCapabilities.cpp. In de volgende tabel worden alle opdrachten voor apparaatfunctionaliteit beschreven, samen met de namen van de handlers die DispatchMessage aanroept wanneer een bepaalde opdracht wordt verwerkt.

Bevelen Verwerker Beschrijving
WPD_COMMAND_SERVICE_CAPABILITIES_GET_SUPPORTED_COMMANDS OnGetSupportedCommands Uitgegeven wanneer een toepassing probeert de set opdrachten op te halen die worden ondersteund door de opgegeven service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_COMMAND_OPTIONS OnGetCommandOptions Uitgegeven wanneer een toepassing probeert de opties op te halen die worden ondersteund door een bepaalde opdracht.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_SUPPORTED_METHODS OnGetSupportedMethods Uitgegeven wanneer een toepassing probeert de methoden op te halen die worden ondersteund door de opgegeven service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_SUPPORTED_METHODS_BY_FORMAT OnGetSupportedMethodsByFormat Uitgevoerd wanneer een toepassing probeert de methoden op te halen die worden ondersteund door een specifiek formaat op de opgegeven service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_METHOD_ATTRIBUTES OnGetMethodAttributes Uitgegeven wanneer een toepassing de kenmerken voor een bepaalde methode probeert op te halen.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_METHOD_PARAMETER_ATTRIBUTES OnGetMethodParameterAttributes Uitgegeven wanneer een toepassing de kenmerken voor een bepaalde methodeparameter probeert op te halen.
WPD_OPDRACHT_SERVICE_CAPACITEITEN_VERKRIJG_ONGESTEUNDE_FUNCTIONELE_CATEGORIEËN OnGetFunctionalCategories Uitgegeven wanneer een toepassing probeert de set functionele categorieën op te halen die worden ondersteund door de opgegeven service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_SUPPORTED_FORMATS OnGetSupportedFormats Uitgegeven wanneer een toepassing probeert de indelingen op te halen die worden ondersteund door een bepaalde service.
[No improvement necessary; retains original.] OnGetFormatAttributes Uitgegeven wanneer een toepassing probeert de kenmerken op te halen van een bepaalde indeling die wordt ondersteund door de service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_SUPPORTED_FORMAT_PROPERTIES OnGetSupportedFormatProperties Uitgegeven wanneer een toepassing probeert de set eigenschappen op te halen die worden ondersteund door een bepaalde indeling.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_FORMAT_PROPERTY_ATTRIBUTES BijFormatPropertyAttributenOphalen Uitgegeven wanneer een toepassing probeert de set eigenschapskenmerken op te halen voor een bepaalde indeling in de service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_SUPPORTED_EVENTS OnGetSupportedEvents Uitgegeven wanneer een toepassing probeert de gebeurtenissen op te halen die worden ondersteund door de opgegeven service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_EVENT_ATTRIBUTES (Ophalen van gebeurtenisattributen van servicedoelen) OnGetEventAttributes Uitgegeven wanneer een toepassing de kenmerken voor een bepaalde gebeurtenis op de service probeert op te halen.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_EVENT_PARAMETER_ATTRIBUTES OnGetEventParameterAttributes Uitgegeven wanneer een toepassing probeert de parameterkenmerken voor een bepaalde gebeurtenis op te halen in de service.
WPD_COMMAND_SERVICE_CAPABILITIES_GET_INHERITED_SERVICES OnGetInheritedServices Uitgegeven wanneer een toepassing probeert de services op te halen die worden overgenomen door de opgegeven service.

De WpdServiceSampleDriver

De WPD-Stuurprogrammavoorbeelden