Método IDiscRecorder2Ex::GetByteAlignmentMask (imapi2.h)
Recupera a máscara de alinhamento de bytes para o dispositivo.
Sintaxe
HRESULT GetByteAlignmentMask(
[out] ULONG *value
);
Parâmetros
[out] value
Máscara de alinhamento de bytes que você usa para determinar se o buffer está alinhado ao limite de bytes correto para o dispositivo. O valor de alinhamento de bytes é sempre um número que é uma potência de 2.
Valor retornado
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
| Código de retorno | Descrição |
|---|---|
|
O ponteiro não é válido.
Valor: 0x80004003 |
|
Falha não especificada.
Valor: 0x80004005 |
Comentários
O buffer de dados para IDiscRecorder2Ex::SendCommandSendDataToDevice e IDiscRecorder2Ex::SendCommandGetDataFromDevice deve estar alinhado ao limite de bytes correto. Para determinar se o buffer está no limite de bytes correto, execute um AND lógico bit a bit da máscara de bits com o endereço do buffer de dados. Por exemplo, se o endereço do buffer for 0x3840958, você poderá testar o alinhamento correto usando a seguinte instrução:
if (0x3840958 & (value - 1) == 0)
{
// The alignment is correct
}
Requisitos
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi2.h |
Confira também
IDiscRecorder2Ex::SendCommandGetDataFromDevice