ISCardTypeConv :: CreateByteBuffer, méthode
[La méthode CreateByteBuffer peut être utilisée dans les systèmes d’exploitation spécifiés dans la section relative à la configuration requise. elle n’est pas disponible pour une utilisation dans Windows server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. Les modules de carte à puce offrent des fonctionnalités similaires.]
La méthode CreateByteBuffer crée une mémoire tampon universelle d’octets mappés dans un objet IStream (IByteBuffer).
La mémoire tampon d’octets créée est un flux mappé sur un bloc de mémoire. Pour accéder à la mémoire tampon ou la gérer, utilisez les méthodes fournies par l’interface IStream . Une fonctionnalité unique de cette implémentation de tableau est que lorsque vous appelez la méthode IStream :: Release , la mémoire sous-jacente est libérée pour vous.
Syntaxe
HRESULT CreateByteBuffer(
[in] DWORD dwAllocSize,
[out] LPBYTEBUFFER *ppbyBuff
);
Paramètres
-
dwAllocSize [ dans]
-
Taille en octets de la mémoire à allouer pour le tableau.
-
ppbyBuff [ à]
-
Pointeur vers l’objet IStream à retourner.
Valeur de retour
Les valeurs de retour possibles sont les suivantes :
| Code de retour | Description |
|---|---|
|
Mémoire allouée avec succès. |
|
Il y a un problème avec un ou plusieurs des paramètres transmis à la fonction. |
|
Mémoire libre insuffisante pour satisfaire la demande. |
Notes
La mémoire allouée est déplaçable. Utilisez la méthode IStream :: Release pour libérer de la mémoire.
Pour créer un tableau d’octets C/C++ classique, appelez CreateByteArray.
Pour créer un SAFEARRAY Automation de caractères non signés (octets), appelez CreateSafeArray.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau XP uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| Fin de la prise en charge des clients |
Windows XP |
| Fin de la prise en charge des serveurs |
Windows Server 2003 |
| En-tête |
|
| Bibliothèque de types |
|
| DLL |
|
| IID |
IID _ ISCardTypeConv est défini en tant que 53B6AA63-3F56-11D0-916B-00AA00C18068 |