Поделиться через


Метод IDiscRecorder2Ex::GetByteAlignmentMask (imapi2.h)

Извлекает маску выравнивания байтов для устройства.

Синтаксис

HRESULT GetByteAlignmentMask(
  [out] ULONG *value
);

Параметры

[out] value

Маска выравнивания байтов, используемая для определения того, выравнивается ли буфер по правильной границе байтов для устройства. Значение выравнивания байтов всегда является числом, равным 2.

Возвращаемое значение

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата Описание
E_POINTER
Недопустимый указатель.

Значение: 0x80004003

E_FAIL
Неопределенный сбой.

Значение: 0x80004005

Комментарии

Буфер данных для IDiscRecorder2Ex::SendCommandSendDataToDevice и IDiscRecorder2Ex::SendCommandGetDataFromDevice должен соответствовать правильной границе байтов. Чтобы определить, находится ли буфер на правильной границе байтов, выполните побитовое логическое И битовой маски с адресом буфера данных. Например, если адрес буфера 0x3840958, можно проверить правильность выравнивания с помощью следующей инструкции:

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

Требования

   
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi2.h

См. также раздел

IDiscRecorder2Ex

IDiscRecorder2Ex::SendCommandGetDataFromDevice

IDiscRecorder2Ex::SendCommandNoData

IDiscRecorder2Ex::SendCommandSendDataToDevice