Freigeben über


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 WdfCommonBufferCreateabgerufen 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.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zu allgemeinen Puffern finden Sie unter Using Common Buffers

Beispiele

Im folgenden Codebeispiel wird die Länge eines angegebenen allgemeinen Puffers ermittelt.

size_t bufferLength;

bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer); 

Anforderungen

Anforderung Wert
Zielplattform- Universal
Minimale KMDF-Version 1.0
Header- wdfcommonbuffer.h (include WdfCommonBuffer.h)
Library Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL- <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WdfCommonBufferCreate