ISCPSecureExchange2 ::TransferContainerData2, méthode (mswmdm.h)

Article
08/25/2023

La méthode TransferContainerData2 transfère les données de fichier conteneur au fournisseur de contenu sécurisé. Le fournisseur de contenu sécurisé décompose le conteneur en interne et indique quelles parties du contenu sont disponibles à mesure qu’elles sont extraites du conteneur. Cette méthode étend ISCPSecureExchange ::TransferContainerData en acceptant un rappel de progression sur lequel le fournisseur de contenu sécurisé peut envoyer des notifications de progression pour toutes les étapes qu’il doit effectuer.

Syntaxe

HRESULT TransferContainerData2(
  [in]      BYTE           *pData,
  [in]      DWORD          dwSize,
  [in]      IWMDMProgress3 *pProgressCallback,
  [out]     UINT           *pfuReadyFlags,
  [in, out] BYTE [8]       abMac
);

Paramètres

[in] pData

Pointeur vers une mémoire tampon contenant les données actuelles transférées à partir du fichier conteneur. Ce paramètre doit être inclus dans le code d’authentification du message d’entrée et doit être chiffré.

[in] dwSize

DWORD qui contient le nombre d’octets dans la mémoire tampon. Ce paramètre doit être inclus dans le code d’authentification du message d’entrée.

[in] pProgressCallback

Rappel de progression sur lequel le fournisseur de contenu sécurisé peut signaler la progression de toutes les étapes qu’il peut avoir besoin d’effectuer. L’étape sera identifiée par le paramètre EventId des méthodes IWMDMProgress3 .

[out] pfuReadyFlags

Indicateur indiquant quelles parties du fichier conteneur sont prêtes à être lues. Ce paramètre est inclus dans le code d’authentification du message de sortie. Les indicateurs suivants indiquent ce qui est prêt.

Indicateur	Description
WMDM_SCP_TRANSFER_OBJECTDATA	Les données de l’objet sont disponibles en appelant la méthode ObjectData .
WMDM_SCP_NO_MORE_CHANGES	Le fournisseur de contenu sécurisé a déterminé qu’il ne nécessite aucun traitement et/ou modification supplémentaire du fichier transféré. Les Gestionnaire de périphériques Windows Media peuvent transférer directement le reste du fichier vers l’appareil.

[in, out] abMac

Tableau de huit octets contenant le code d’authentification de message pour les données de paramètre de cette méthode. (WMDM_MAC_LENGTH est défini sur 8.)

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, elle retourne un code d’erreur HRESULT .

Code de retour	Description
WMDM_E_NOT_CERTIFIED	L’appelant n’est pas autorisé à utiliser cette interface.
WMDM_E_NORIGHTS	L’appelant ne dispose pas des droits requis pour effectuer l’opération demandée.
WMDM_E_MAC_CHECK_FAILED	Le code d’authentification du message n’est pas valide.
S_FALSE	Échec de la méthode. Arrêter l’interaction avec le fournisseur de contenu sécurisé.
E_INVALIDARG	Un paramètre n’est pas valide ou est un pointeur NULL .
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Windows Media Gestionnaire de périphériques appelle cette méthode à plusieurs reprises, transférant les données du fichier conteneur vers le fournisseur de contenu sécurisé. Windows Media Gestionnaire de périphériques appelle finalement cette méthode avec dwSize défini sur zéro pour indiquer qu’il n’a plus de données à transférer. Lorsque le fournisseur de contenu sécurisé collecte les données et en extrait les différents objets, il signale à Windows Media Gestionnaire de périphériques quels objets, le cas échéant, sont disponibles après chaque appel. Si aucun objet n’est disponible, le fournisseur de contenu sécurisé retourne S_OK avec le paramètre pfuReadyFlags défini sur zéro. Lorsque le fournisseur de contenu sécurisé a déterminé qu’il ne nécessite aucun traitement et/ou modification supplémentaire du fichier transféré, l’indicateur WMDM_SCP_NO_MORE_CHANGES est retourné. Les Gestionnaire de périphériques Windows Media peuvent ensuite transférer directement le reste du fichier vers l’appareil.

Les données d’objet sont transférées à partir du fournisseur de contenu sécurisé en appelant la méthode ObjectData . Windows Media Gestionnaire de périphériques appelle ObjectData à plusieurs reprises jusqu’à ce qu’il retourne zéro dans le deuxième paramètre, dwBytesWrite.

La méthode TransferComplete est appelée par Windows Media Gestionnaire de périphériques pour signaler la fin d’un transfert sécurisé de données.

Windows Media Gestionnaire de périphériques transmet le rappel de progression fourni par l’application au fournisseur de contenu sécurisé dans le paramètre pProgressCallback. Le fournisseur de contenu sécurisé peut utiliser ce paramètre pour fournir une notification de progression pour toutes les étapes qu’il doit effectuer. L’étape elle-même est identifiée par EventId, qui est le premier paramètre des méthodes de IWMDMProgress3. Une implémentation de fournisseur de contenu sécurisé spécifique définit des valeurs EventId pour les applications à utiliser.