共用方式為


WdfRequestProbeAndLockUserBufferForWrite 函式 (wdfrequest.h)

[僅適用於 KMDF]

WdfRequestProbeAndLockUserBufferForWrite 方法會驗證 I/O 要求的使用者模式緩衝區可寫入,然後鎖定緩衝區的實體記憶體頁面,讓驅動程式堆疊中的驅動程式可以寫入緩衝區。

語法

NTSTATUS WdfRequestProbeAndLockUserBufferForWrite(
  [in]  WDFREQUEST Request,
  [in]  PVOID      Buffer,
  [in]  size_t     Length,
  [out] WDFMEMORY  *MemoryObject
);

參數

[in] Request

架構要求物件的句柄。

[in] Buffer

要求輸出緩衝區的指標。 如需詳細資訊,請參閱接下來的<備註>一節。

[in] Length

要求的輸出緩衝區長度,以位元組為單位。

[out] MemoryObject

位置的指標,該位置會接收代表使用者輸出緩衝區之架構記憶體物件的句柄。

傳回值

WdfRequestProbeAndLockUserBufferForWrite 會在作業成功時傳回STATUS_SUCCESS。 否則,此方法可能會傳回下列其中一個值:

傳回碼 Description
STATUS_INVALID_PARAMETER
輸入參數無效。
STATUS_INVALID_USER_BUFFER
Length 參數為零。
STATUS_INVALID_DEVICE_REQUEST
要求已經完成或無效。
STATUS_ACCESS_VIOLATION
目前的線程不是 I/O 要求的建立者。
STATUS_INSUFFICIENT_RESOURCES
記憶體不足,無法完成作業。
 

這個方法也可能傳回其他 NTSTATUS值

如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。

備註

用戶輸出緩衝區通常會接收驅動程式從裝置讀取的資訊。

只有最上層驅動程式可以呼叫 WdfRequestProbeAndLockUserBufferForWrite 方法,因為方法需要建立 I/O 要求之進程的進程內容。

Buffer 參數指定的使用者模式緩衝區可以是 WdfRequestRetrieveUnsafeUserOutputBuffer 擷取的緩衝區,或者它可以是不同的使用者模式輸出緩衝區。 例如,使用緩衝存取方法的 I/O 控制項程式代碼可能會傳遞包含使用者模式緩衝區內嵌指標的結構。 在這種情況下,驅動程式可以使用WdfRequestProbeAndLockUserBufferForWrite 取得緩衝區的記憶體物件。

Length 參數指定的緩衝區長度不能大於緩衝區的實際大小。 否則,驅動程式可以在緩衝區外部存取記憶體,這是安全性風險。

如果 WdfRequestProbeAndLockUserBufferForWrite 傳回STATUS_SUCCESS,驅動程式會接收代表使用者模式緩衝區的架構記憶體物件的句柄。 若要存取緩衝區,驅動程式必須呼叫 WdfMemoryGetBuffer

驅動程式呼叫 WdfRequestComplete 時,會自動釋放架構記憶體物件。

如需 WdfRequestProbeAndLockUserBufferForWrite 的詳細資訊,請參閱 存取 Framework-Based 驅動程式中的數據緩衝區

範例

如需使用 WdfRequestProbeAndLockUserBufferForWrite 的程式代碼範例,請參閱 WdfRequestProbeAndLockUserBufferForRead

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfrequest.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL PASSIVE_LEVEL
DDI 合規性規則 DriverCreate (kmdf) InvalidReqAccess (kmdf ) , InvalidReqAccessLocal (kmdf ) , KmdfIrql (kmdf) KmdfIrql2 (kmdf) , KmdfIrqlExplicit (kmdf)

另請參閱

WdfMemoryGetBuffer

WdfRequestProbeAndLockUserBufferForRead

WdfRequestRetrieveUnsafeUserOutputBuffer