Función WdfMemoryCopyToBuffer (wdfmemory.h)

[Se aplica a KMDF y UMDF]

El método WdfMemoryCopyToBuffer copia el contenido del búfer de un objeto de memoria especificado en un búfer de destino especificado.

Sintaxis

NTSTATUS WdfMemoryCopyToBuffer(
  [in]  WDFMEMORY SourceMemory,
  [in]  size_t    SourceOffset,
  [out] PVOID     Buffer,
  [in]  size_t    NumBytesToCopyTo
);

Parámetros

[in] SourceMemory

Identificador de un objeto de memoria de marco que representa el búfer de origen.

[in] SourceOffset

Desplazamiento, en bytes, desde el principio del búfer de origen. La operación de copia comienza en el desplazamiento especificado en el búfer de origen.

[out] Buffer

Puntero a un búfer de destino.

[in] NumBytesToCopyTo

Número de bytes que se van a copiar desde el búfer de origen al búfer de destino. Este valor no debe ser mayor que el tamaño del búfer de origen.

Valor devuelto

WdfMemoryCopyToBuffer devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver uno de los siguientes valores:

Este método también podría devolver otros valores NTSTATUS.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

El marco de trabajo no permite que el controlador copie más bytes que el búfer de origen que el parámetro SourceMemory especifica puede contener.

Para obtener más información sobre los objetos de memoria del marco, consulte Uso de búferes de memoria.

Si el búfer de origen o destino se asignó desde el grupo de memoria paginable, se debe llamar al método WdfMemoryCopyToBuffer en IRQL <= APC_LEVEL. De lo contrario, se puede llamar al método en cualquier IRQL.

Ejemplos

En el ejemplo de código siguiente se asigna un nuevo búfer y se copia el contenido del búfer de un objeto de memoria en el nuevo búfer.

PVOID  pOutputBuffer = NULL;
NTSTATUS  status = STATUS_SUCCESS;

pOutputBuffer = ExAllocatePoolWithTag(
                                      NonPagedPool,
                                      MY_BUFFER_LENGTH,
                                      MY_POOL_TAG
                                      );
if (pOutputBuffer != NULL){
    status = WdfMemoryCopyToBuffer(
                                   outputMemoryHandle,
                                   0,
                                   pOutputBuffer,
                                   MY_BUFFER_LENGTH
                                   );
}
else{
    status = STATUS_INSUFFICIENT_RESOURCES;
}

Requisitos

Consulte también

WdfMemoryCopyFromBuffer