Metode IDiscRecorder2Ex::GetByteAlignmentMask (imapi2.h)

Mengambil masker perataan byte untuk perangkat.

Sintaks

HRESULT GetByteAlignmentMask(
  [out] ULONG *value
);

Parameter

[out] value

Byte alignment mask yang Anda gunakan untuk menentukan apakah buffer diselaraskan ke batas byte yang benar untuk perangkat. Nilai perataan byte selalu berupa angka yang merupakan kekuatan 2.

Menampilkan nilai

S_OK dikembalikan pada keberhasilan, tetapi kode keberhasilan lainnya dapat dikembalikan sebagai hasil dari implementasi. Kode kesalahan berikut biasanya dikembalikan pada kegagalan operasi, tetapi tidak mewakili satu-satunya nilai kesalahan yang mungkin:

Menampilkan kode	Deskripsi
E_POINTER	Penunjuk tidak valid. Nilai: 0x80004003
E_FAIL	Kegagalan yang tidak ditentukan. Nilai: 0x80004005

Keterangan

Buffer data untuk IDiscRecorder2Ex::SendCommandSendDataToDevice dan IDiscRecorder2Ex::SendCommandGetDataFromDevice harus diselaraskan ke batas byte yang benar. Untuk menentukan apakah buffer berada pada batas byte yang benar, lakukan logis bitwise DAN bitmask dengan alamat buffer data. Misalnya, jika alamat buffer 0x3840958, Anda dapat menguji perataan yang benar menggunakan pernyataan berikut:

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

Persyaratan

Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imapi2.h

Lihat juga

IDiscRecorder2Ex

IDiscRecorder2Ex::SendCommandGetDataFromDevice

IDiscRecorder2Ex::SendCommandNoData

IDiscRecorder2Ex::SendCommandSendDataToDevice