IMF2DBuffer：：Lock2D 方法 (mfobjects.h)

  • 發行項

讓呼叫端能夠存取緩衝區中的記憶體。

語法

HRESULT Lock2D(
  [out] BYTE **ppbScanline0,
  [out] LONG *plPitch
);

參數

[out] ppbScanline0

接收影像中像素頂端數據列第一個字節的指標。 當影像呈現給查看器時，頂端數據列會定義為頂端數據列，而且可能不是記憶體中的第一個數據列。

[out] plPitch

接收表面步進，以位元組為單位。 該步幅可能是負數，表示影像是從記憶體中底部向上導向。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
D3DERR_INVALIDCALL
 無法鎖定 Direct3D 表面。
MF_E_INVALIDREQUEST
 目前無法鎖定緩衝區。

備註

如果 p 是圖元列中第一個字節的指標， p + (*plPitch) 指向下一個像素列中的第一個字節。 緩衝區可能包含每個像素數據列之後的邊框間距，因此步幅可能會比影像的寬度還要寬，以位元組為單位。 請勿存取保留給填補位元組的記憶體，因為它可能無法讀取或可寫入。 如需詳細資訊，請參閱 Image Stride。

只要呼叫端保留鎖定， pbScanline0 中傳回的指標就會保持有效。 當您完成記憶體存取時，請呼叫 IMF2DBuffer：：Unlock2D 來解除鎖定緩衝區。 您必須針對 Lock2D 的每個呼叫呼叫一次 Unlock2D。 解除鎖定緩衝區之後， pbScanline0 中傳回的指標已不再有效，不應使用。 一般而言，只有在您需要存取緩衝區內存，而不是稍早時，才最好呼叫 Lock2D 。

IMFMediaBuffer：：GetCurrentLength 和 IMFMediaBuffer：：GetMaxLength 方法所傳回的值不適用於 Lock2D 方法所傳回的緩衝區。 基於相同的理由，在操作 Lock2D 方法傳回的緩衝區中的數據之後，您不需要呼叫 IMFMediaBuffer：：SetCurrentLength。

在保留 Lock2D鎖定時，IMFMediaBuffer：：Lock 方法會失敗，反之亦然。 應用程式一次只能使用其中一種方法。

當基礎緩衝區是 Direct3D 表面時，如果介面無法鎖定，方法就會失敗。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfobjects.h (包含 Mfidl.h)
程式庫 Mfuuid.lib

另請參閱

IMF2DBuffer

媒體緩衝區

未壓縮的視訊緩衝區