IWDFMemory::CopyFromMemory 方法 (wudfddi.h)
警告
UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1,而且較新版本的 Windows 10 上,UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用UMDF使用者入門。
CopyFromMemory 方法會安全地從指定的來源緩衝區複製數據,並防止複製作業可能造成溢位。
語法
HRESULT CopyFromMemory(
[in] IWDFMemory *Source,
[in, optional] PWDFMEMORY_OFFSET SourceOffset
);
參數
[in] Source
記憶體物件之 IWDFMemory 介面的指標,該對像是複製作業的來源。
[in, optional] SourceOffset
WDFMEMORY_OFFSET 結構的指標,描述從記憶體區塊複製的資訊。 這是選擇性參數。 如果複製整個來源緩衝區,驅動程式可以傳遞 NULL 。
如果不是 NULL,WDFMEMORY_OFFSET 結構的 BufferOffset 成員會指出來源緩衝區中的位移,以便從中啟動複製作業。
BufferLength 成員應設定為 0;架構會忽略此成員,因為複製的數據量取決於目前目的地緩衝區的長度和位移組合。
傳回值
如果作業成功,CopyFromMemory 會傳回S_OK。 否則,這個方法會傳回 Winerror.h 中定義的其中一個錯誤碼。
規格需求
需求 | 值 |
---|---|
終止支援 | 在 UMDF 2.0 和更新版本中無法使用。 |
目標平台 | 桌面 |
最低UMDF版本 | 1.5 |
標頭 | wudfddi.h (包含 Wudfddi.h) |
Dll | WUDFx.dll |