summaryrefslogtreecommitdiffstats
path: root/src/audio_core/hle/pipe.h
diff options
context:
space:
mode:
authorAlexander Laties <alex.laties@gmail.com>2016-04-25 22:10:03 +0200
committerAlexander Laties <alex.laties@gmail.com>2016-05-07 17:41:55 +0200
commit0a31e373f1728316b3dfed391ddcb99a474e4102 (patch)
tree1b1bcf1af2398481e7208610f6a2e49264fe11db /src/audio_core/hle/pipe.h
parentMerge pull request #1736 from MerryMage/sdl2-sink (diff)
downloadyuzu-0a31e373f1728316b3dfed391ddcb99a474e4102.tar
yuzu-0a31e373f1728316b3dfed391ddcb99a474e4102.tar.gz
yuzu-0a31e373f1728316b3dfed391ddcb99a474e4102.tar.bz2
yuzu-0a31e373f1728316b3dfed391ddcb99a474e4102.tar.lz
yuzu-0a31e373f1728316b3dfed391ddcb99a474e4102.tar.xz
yuzu-0a31e373f1728316b3dfed391ddcb99a474e4102.tar.zst
yuzu-0a31e373f1728316b3dfed391ddcb99a474e4102.zip
Diffstat (limited to '')
-rw-r--r--src/audio_core/hle/pipe.h12
1 files changed, 8 insertions, 4 deletions
diff --git a/src/audio_core/hle/pipe.h b/src/audio_core/hle/pipe.h
index 64d97f8ba..b714c0496 100644
--- a/src/audio_core/hle/pipe.h
+++ b/src/audio_core/hle/pipe.h
@@ -24,10 +24,14 @@ enum class DspPipe {
constexpr size_t NUM_DSP_PIPE = 8;
/**
- * Read a DSP pipe.
- * @param pipe_number The Pipe ID
- * @param length How much data to request.
- * @return The data read from the pipe. The size of this vector can be less than the length requested.
+ * Reads `length` bytes from the DSP pipe identified with `pipe_number`.
+ * @note Can read up to the maximum value of a u16 in bytes (65,535).
+ * @note IF an error is encoutered with either an invalid `pipe_number` or `length` value, an empty vector will be returned.
+ * @note IF `length` is set to 0, an empty vector will be returned.
+ * @note IF `length` is greater than the amount of data available, this function will only read the available amount.
+ * @param pipe_number a `DspPipe`
+ * @param length the number of bytes to read. The max is 65,535 (max of u16).
+ * @returns a vector of bytes from the specified pipe. On error, will be empty.
*/
std::vector<u8> PipeRead(DspPipe pipe_number, u32 length);