Función WdfCommonBufferGetLength (wdfcommonbuffer.h)
[Solo se aplica a KMDF]
El método WdfCommonBufferGetLength devuelve la longitud de un búfer común especificado.
Sintaxis
size_t WdfCommonBufferGetLength(
[in] WDFCOMMONBUFFER CommonBuffer
);
Parámetros
[in] CommonBuffer
Identificador de un objeto de búfer común que el controlador obtuvo mediante una llamada anterior a WdfCommonBufferCreate.
Valor devuelto
WdfCommonBufferGetLength devuelve la longitud, en bytes, del búfer asociado al búfer común que especifica el parámetro CommonBuffer .
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
Para obtener más información sobre los búferes comunes, consulte Uso de búferes comunes.
Ejemplos
En el ejemplo de código siguiente se obtiene la longitud de un búfer común especificado.
size_t bufferLength;
bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfcommonbuffer.h (incluya WdfCommonBuffer.h) |
| Library | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |