IDiscRecorder2Ex::GetByteAlignmentMask 方法 (imapi2.h)

检索设备的字节对齐掩码。

语法

HRESULT GetByteAlignmentMask(
  [out] ULONG *value
);

parameters

[out] value

用于确定缓冲区是否与设备的正确字节边界对齐的字节对齐掩码。 字节对齐值始终为 2 的幂数字。

返回值

成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_POINTER
指针无效。

值:0x80004003

E_FAIL
未知故障。

值:0x80004005

注解

IDiscRecorder2Ex::SendCommandSendDataToDeviceIDiscRecorder2Ex::SendCommandGetDataFromDevice 的数据缓冲区必须与正确的字节边界对齐。 若要确定缓冲区是否位于正确的字节边界上,请使用数据缓冲区的地址对位掩码执行按位逻辑 AND。 例如,如果缓冲区的地址0x3840958,则可以使用以下语句测试是否正确对齐:

if (0x3840958 & (value - 1) == 0)
{
    // The alignment is correct
}

要求

   
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2.h

另请参阅

IDiscRecorder2Ex

IDiscRecorder2Ex::SendCommandGetDataFromDevice

IDiscRecorder2Ex::SendCommandNoData

IDiscRecorder2Ex::SendCommandSendDataToDevice