WdfCommonBufferGetLength 函式（wdfcommonbuffer.h）

[僅適用於 KMDF]

WdfCommonBufferGetLength 方法會傳回指定之通用緩衝區的長度。

語法

size_t WdfCommonBufferGetLength(
  [in] WDFCOMMONBUFFER CommonBuffer
);

[in] CommonBuffer

由先前呼叫 WdfCommonBufferCreate取得之驅動程式所取得之通用緩衝區物件的句柄。

WdfCommonBufferGetLength 會傳回與 commonBuffer 參數所指定之通用緩衝區相關聯的緩衝區長度，以位元組為單位。

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

如需常見緩衝區的詳細資訊，請參閱使用通用緩衝區

下列程式代碼範例會取得指定之通用緩衝區的長度。

size_t bufferLength;

bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer);

要求	價值
目標平臺	普遍
最低 KMDF 版本	1.0
標頭	wdfcommonbuffer.h （包括 WdfCommonBuffer.h）
連結庫	Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）