Méthode IWDFMemory ::CopyFromMemory (wudfddi.h)

  • Article

Avertissement

UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.

La méthode CopyFromMemory copie en toute sécurité les données de la mémoire tampon source spécifiée et empêche les dépassements que l’opération de copie pourrait entraîner autrement.

Syntaxe

HRESULT CopyFromMemory(
  [in]           IWDFMemory        *Source,
  [in, optional] PWDFMEMORY_OFFSET SourceOffset
);

Paramètres

[in] Source

Pointeur vers l’interface IWDFMemory pour l’objet mémoire qui est la source de l’opération de copie.

[in, optional] SourceOffset

Pointeur vers une structure de WDFMEMORY_OFFSET qui décrit les informations copiées à partir d’un bloc de mémoire. Ce paramètre est facultatif. Le pilote peut passer null si la mémoire tampon source entière est copiée.

Le membre BufferOffset de la structure WDFMEMORY_OFFSET, si ce n’est pas NULL, indique le décalage dans la mémoire tampon source à partir duquel démarrer l’opération de copie.

Le membre BufferLength doit être défini sur 0 ; l’infrastructure ignore ce membre, car la quantité de données copiées dépend de la combinaison de longueur et de décalage de la mémoire tampon de destination actuelle.

Valeur retournée

CopyFromMemory retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1.5
En-tête wudfddi.h (inclure Wudfddi.h)
DLL WUDFx.dll

Voir aussi