Metodo IDiscRecorder2Ex::GetByteAlignmentMask (imapi2.h)
Recupera la maschera di allineamento dei byte per il dispositivo.
Sintassi
HRESULT GetByteAlignmentMask(
[out] ULONG *value
);
Parametri
[out] value
Maschera di allineamento byte usata per determinare se il buffer è allineato al limite di byte corretto per il dispositivo. Il valore di allineamento dei byte è sempre un numero che rappresenta una potenza di 2.
Valore restituito
S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:
| Codice restituito | Descrizione |
|---|---|
|
Puntatore non valido.
Valore: 0x80004003 |
|
Errore non specificato.
Valore: 0x80004005 |
Commenti
Il buffer dei dati per IDiscRecorder2Ex::SendCommandSendDataToDevice e IDiscRecorder2Ex::SendCommandGetDataFromDevice deve essere allineato al limite di byte corretto. Per determinare se il buffer si trova nel limite di byte corretto, eseguire un AND logico bit per bit della maschera di bit con l'indirizzo del buffer di dati. Ad esempio, se l'indirizzo del buffer è 0x3840958, è possibile verificare l'allineamento corretto usando l'istruzione seguente:
if (0x3840958 & (value - 1) == 0)
{
// The alignment is correct
}
Requisiti
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imapi2.h |
Vedi anche
IDiscRecorder2Ex::SendCommandGetDataFromDevice