WdfRequestRetrieveUnsafeUserOutputBuffer 函式 (wdfrequest.h)

[僅適用于 KMDF]

如果存取資料緩衝區的要求技術不是緩衝處理或直接 I/OWdfRequestRetrieveUnsafeUserOutputBuffer方法會擷取 I/O 要求的輸出緩衝區。

語法

NTSTATUS WdfRequestRetrieveUnsafeUserOutputBuffer(
  [in]            WDFREQUEST Request,
  [in]            size_t     MinimumRequiredLength,
  [out]           PVOID      *OutputBuffer,
  [out, optional] size_t     *Length
);

參數

[in] Request

架構要求物件的控制碼。

[in] MinimumRequiredLength

驅動程式需要處理 I/O 要求的最小緩衝區大小,以位元組為單位。

[out] OutputBuffer

接收緩衝區位址之位置的指標。

[out, optional] Length

接收緩衝區大小之位置的指標,以位元組為單位。 這個參數是選擇性的,而且可以是 Null

傳回值

如果作業成功,WdfRequestRetrieveUnsafeUserOutputBuffer會傳回STATUS_SUCCESS。 否則,這個方法可能會傳回下列其中一個值:

傳回碼 描述
STATUS_INVALID_PARAMETER
輸入參數無效。
STATUS_INVALID_DEVICE_REQUEST
如果發生下列其中一項,則會傳回此值:
STATUS_BUFFER_TOO_SMALL
MinimumRequiredLength參數會指定大於緩衝區實際大小的緩衝區大小。
 

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

如果驅動程式提供不正確物件控制碼,就會發生錯誤檢查。

備註

WdfRequestRetrieveUnsafeUserOutputBuffer方法必須從EvtIoInCallerCoNtext 回呼函式呼叫。 呼叫 WdfRequestRetrieveUnsafeUserOutputBuffer之後,驅動程式必須呼叫 WdfRequestProbeAndLockUserBufferForWrite

如果要求的 I/O 控制項程式碼IRP_MJ_READIRP_MJ_DEVICE_CONTROL,驅動程式可以呼叫WdfRequestRetrieveUnsafeUserOutputBuffer

驅動程式可以存取擷取的緩衝區,直到它完成Request參數所代表的I/O 要求為止。

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

範例

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

規格需求

   
目標平臺 環球
最低 KMDF 版本 1.0
標頭 wdfrequest.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL PASSIVE_LEVEL
DDI 合規性規則 BufAfterReqCompletedIntIoctl (kmdf) BufAfterReqCompletedIntIoctlA (kmdf) BufAfterReqCompletedIoctl (kmdf ) 、 BufAfterReqCompletedIoctlA (kmdf) BufAfterReqCompletedRead) (kmdf) BufAfterReqCompletedReadA (kmdf) BufAfterReqCompletedWrite (kmdf) DriverCreate (kmdf ) 、 InvalidReqAccess (kmdf) InvalidReqAccessLocal (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf) 、 OutputBufferAPI (kmdf)

另請參閱

EvtIoInCallerCoNtext

WdfRequestProbeAndLockUserBufferForWrite

WdfRequestRetrieveUnsafeUserInputBuffer