IDmaChannel::CopyTo

The CopyTo method copies sample data to the DMA channel's common buffer from the specified source buffer.

NTSTATUS
  CopyTo(
    IN PVOID  Destination,
    IN PVOID  Source,
    IN ULONG  ByteCount
    );

Parameters

Destination

Pointer to the destination buffer, which is located in the DMA channel's common buffer.

Source

Pointer to the source buffer

ByteCount

Specifies the number of bytes to be copied.

Return Value

CopyTo returns STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code.

Headers

Declared in portcls.h. Include portcls.h.

Comment

The Source and Destination pointers are both kernel-mode virtual addresses. The IDmaChannel::SystemAddress call returns the virtual address of a DMA channel's common buffer.

The Destination parameter points to the beginning of the destination buffer, which occupies ByteCount contiguous bytes in the DMA channel's common buffer.

Callers of CopyTo can run at any IRQL.

See Also

IDmaChannel::SystemAddress