WdfCommonBufferGetLength 函数 (wdfcommonbuffer.h)

  • 项目

[仅适用于 KMDF]

WdfCommonBufferGetLength 方法返回指定公共缓冲区的长度。

语法

size_t WdfCommonBufferGetLength(
  [in] WDFCOMMONBUFFER CommonBuffer
);

参数

[in] CommonBuffer

驱动程序通过上一次调用 WdfCommonBufferCreate 获取的公共缓冲区对象的句柄。

返回值

WdfCommonBufferGetLength 返回与 CommonBuffer 参数指定的公共缓冲区关联的缓冲区的长度（以字节为单位）。

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

注解

有关常见缓冲区的详细信息，请参阅 使用通用缓冲区

示例

下面的代码示例获取指定公共缓冲区的长度。

size_t bufferLength;

bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer);

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfcommonbuffer.h (包括 WdfCommonBuffer.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另请参阅

WdfCommonBufferCreate