Méthode IWMDMProgress3 ::End3 (mswmdm.h)

Article
02/29/2024

La méthode End3 est appelée par Windows Media Gestionnaire de périphériques pour indiquer qu’une opération est terminée. Cette méthode étend IWMDMProgress2 ::End2 en fournissant des paramètres d’entrée supplémentaires pour l’identification (ID) de l’événement et pour un pointeur vers le contexte des commandes.

Syntaxe

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

Paramètres

[in] EventId

GUID spécifiant l’événement qui se termine. Les valeurs possibles sont présentées dans le tableau suivant.

Événement	Description
SCP_EVENTID_ACQSECURECLOCK	Windows Media Gestionnaire de périphériques acquiert une horloge sécurisée auprès du serveur.
SCP_EVENTID_NEEDTOINDIV	L’appareil est en cours d’individualisation. Il n’est pas utilisé actuellement.
SCP_EVENTID_DRMINFO	Cet ID d’événement est utilisé pour notifier l’application avec l’en-tête DRM de version trouvé dans le contenu de chaque fichier. La structure OPAQUECOMMAND retournée a le membre guidCommand défini sur SCP_PARAMID_DRMVERSION. En outre, les données spécifient l’un des indicateurs suivants : WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	Le contenu est transféré vers ou depuis l’appareil.

[in] hrCompletionCode

HRESULT spécifiant le code d’achèvement de l’opération en cours. Le paramètre hrCompletionCode est le code de retour de l’opération qui s’est terminée. Ce paramètre peut être n’importe quel HRESULT, y compris les codes d’erreur COM standard, les codes d’erreur Win32 convertis en HRESULT ou les codes d’erreur windows Media Gestionnaire de périphériques.

[in, out] pContext

Pointeur vers une structure OPAQUECOMMAND contenant une commande envoyée directement à l’appareil sans être gérée par Windows Media Gestionnaire de périphériques. Ce paramètre est facultatif et peut être NULL. La structure de contexte est un moyen pour le composant d’envoyer toutes les données pertinentes avec l’événement à l’application. Le composant qui envoie cette structure doit définir la façon dont l’application peut interpréter cette structure de données.

Valeur retournée

Windows Media Gestionnaire de périphériques ignore tout code de retour retourné par la méthode End3, car l’opération en cours est terminée ou annulée avant l’appel de cette méthode.

Remarques

L’interface propriétaire de la méthode qui implémente une opération appelle End3 lorsque l’opération définie par la méthode est terminée.

Exemples

Le code C++ suivant montre un exemple d’implémentation de End3.


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}