Méthode IDiscRecorder2Ex::GetByteAlignmentMask (imapi2.h)
Récupère le masque d’alignement d’octets pour l’appareil.
Syntaxe
HRESULT GetByteAlignmentMask(
[out] ULONG *value
);
Paramètres
[out] value
Masque d’alignement d’octets que vous utilisez pour déterminer si la mémoire tampon est alignée sur la limite d’octet correcte pour l’appareil. La valeur d’alignement d’octets est toujours un nombre qui est une puissance de 2.
Valeur retournée
S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :
| Code de retour | Description |
|---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
Défaillance non spécifiée.
Valeur : 0x80004005 |
Notes
La mémoire tampon de données pour IDiscRecorder2Ex::SendCommandSendDataToDevice et IDiscRecorder2Ex::SendCommandGetDataFromDevice doit être alignée sur la limite d’octet correcte. Pour déterminer si la mémoire tampon se trouve sur la limite d’octet correcte, effectuez un AND logique au niveau du bit du masque de bits avec l’adresse de la mémoire tampon de données. Par exemple, si l’adresse de la mémoire tampon est 0x3840958, vous pouvez tester l’alignement correct à l’aide de l’instruction suivante :
if (0x3840958 & (value - 1) == 0)
{
// The alignment is correct
}
Configuration requise
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi2.h |
Voir aussi
IDiscRecorder2Ex::SendCommandGetDataFromDevice