ISCPSecureExchange ::TransferContainerData, méthode (mswmdm.h)

Article
08/25/2023

La méthode TransferContainerData 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.

Syntaxe

HRESULT TransferContainerData(
  [in]      BYTE     *pData,
  [in]      DWORD    dwSize,
  [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.

[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	Défini 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é. Windows Media Gestionnaire de périphériques peut 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 comme 8.)

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, il 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 nécessaires pour effectuer l’opération demandée.
WMDM_E_MAC_CHECK_FAILED	Le code d’authentification du message n’est pas valide.
S_FALSE	La méthode a échoué. Mettre fin à 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 finalement appeler cette méthode avec dwSize défini sur zéro pour indiquer qu’elle 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é. Windows Media Gestionnaire de périphériques pouvez 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.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

ISCPSecureExchange Interface

Partager via