擷取裝置的位元組對齊遮罩。
語法
HRESULT GetByteAlignmentMask(
[out] ULONG *value
);
參數
[out] value
您用來判斷緩衝區是否對齊裝置的正確位元組界限的位元組對齊遮罩。 位元組對齊值一律是 2 乘冪的數位。
傳回值
成功時會傳回S_OK,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:
| 傳回碼 | 描述 |
|---|---|
|
指標無效。
值:0x80004003 |
|
未指定的失敗。
值:0x80004005 |
備註
IDiscRecorder2Ex::SendCommandSendDataToDevice和IDiscRecorder2Ex::SendCommandGetDataFromDevice的資料緩衝區必須對齊正確的位元組界限。 若要判斷緩衝區是否位於正確的位元組界限上,請使用資料緩衝區的位址,執行位元遮罩的位邏輯 AND。 例如,如果緩衝區的位址0x3840958,您可以使用下列語句來測試正確的對齊方式:
if (0x3840958 & (value - 1) == 0)
{
// The alignment is correct
}
需求
| 最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | imapi2.h |
另請參閱
IDiscRecorder2Ex::SendCommandGetDataFromDevice