Fungsi WdfCommonBufferGetLength (wdfcommonbuffer.h)
[Hanya berlaku untuk KMDF]
Metode WdfCommonBufferGetLength mengembalikan panjang buffer umum yang ditentukan.
Sintaks
size_t WdfCommonBufferGetLength(
[in] WDFCOMMONBUFFER CommonBuffer
);
Parameter
[in] CommonBuffer
Handel ke objek buffer umum yang diperoleh driver dengan panggilan sebelumnya ke WdfCommonBufferCreate.
Nilai kembali
WdfCommonBufferGetLength mengembalikan panjang, dalam byte, dari buffer yang terkait dengan buffer umum yang ditentukan parameter CommonBuffer .
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Untuk informasi selengkapnya tentang buffer umum, lihat Menggunakan Buffer Umum
Contoh
Contoh kode berikut mendapatkan panjang buffer umum yang ditentukan.
size_t bufferLength;
bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Header | wdfcommonbuffer.h (termasuk WdfCommonBuffer.h) |
| Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
| IRQL | <= DISPATCH_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |