IDiscRecorder2Ex::GetByteAlignmentMask-Methode (imapi2.h)
Ruft die Byteausrichtungsmaske für das Gerät ab.
Syntax
HRESULT GetByteAlignmentMask(
[out] ULONG *value
);
Parameter
[out] value
Byteausrichtungsmaske, die Sie verwenden, um zu bestimmen, ob der Puffer an der richtigen Bytegrenze für das Gerät ausgerichtet ist. Der Byteausrichtungswert ist immer eine Zahl mit einer Potenz von 2.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Unspezifizierter Fehler.
Wert: 0x80004005 |
Hinweise
Der Datenpuffer für IDiscRecorder2Ex::SendCommandSendDataToDevice und IDiscRecorder2Ex::SendCommandGetDataFromDevice muss an der richtigen Bytegrenze ausgerichtet sein. Um zu bestimmen, ob sich der Puffer auf der richtigen Bytegrenze befindet, führen Sie ein bitweises logisches AND der Bitmaske mit der Adresse des Datenpuffers aus. Wenn die Adresse des Puffers z. B. 0x3840958 ist, können Sie die richtige Ausrichtung mit der folgenden Anweisung testen:
if (0x3840958 & (value - 1) == 0)
{
// The alignment is correct
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |
Weitere Informationen
IDiscRecorder2Ex::SendCommandGetDataFromDevice