WdfCommonBufferGetLength 函式 (wdfcommonbuffer.h)
[僅適用於 KMDF]
WdfCommonBufferGetLength 方法會傳回指定之通用緩衝區的長度。
語法
size_t WdfCommonBufferGetLength(
[in] WDFCOMMONBUFFER CommonBuffer
);
參數
[in] CommonBuffer
由先前呼叫 WdfCommonBufferCreate 取得之驅動程式所取得之通用緩衝區物件的句柄。
傳回值
WdfCommonBufferGetLength 會傳回與 CommonBuffer 參數指定之通用緩衝區相關聯的緩衝區長度，以位元組為單位。
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
備註
如需常見緩衝區的詳細資訊，請參閱 使用通用緩衝區
範例
下列程式代碼範例會取得指定之通用緩衝區的長度。
size_t bufferLength;
bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.0 |
| 標頭 | wdfcommonbuffer.h (包含 WdfCommonBuffer.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |