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)

Weitere Informationen

WdfCommonBufferCreate