WdfCommonBufferGetLength-Funktion (wdfcommonbuffer.h)
[Gilt nur für KMDF]
Die WdfCommonBufferGetLength-Methode gibt die Länge eines angegebenen allgemeinen Puffers zurück.
Syntax
size_t WdfCommonBufferGetLength(
[in] WDFCOMMONBUFFER CommonBuffer
);
Parameter
[in] CommonBuffer
Ein Handle für ein allgemeines Pufferobjekt, das der Treiber durch einen vorherigen Aufruf von WdfCommonBufferCreate abgerufen hat.
Rückgabewert
WdfCommonBufferGetLength gibt die Länge des Puffers in Bytes zurück, der dem allgemeinen Puffer zugeordnet ist, den der CommonBuffer-Parameter angibt.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zu allgemeinen Puffern finden Sie unter Verwenden allgemeiner Puffer.
Beispiele
Im folgenden Codebeispiel wird die Länge eines angegebenen allgemeinen Puffers abgerufen.
size_t bufferLength;
bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfcommonbuffer.h (einschließen von WdfCommonBuffer.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |