diff --git a/starboard/player.h b/starboard/player.h
index 01b63bbc3b43..4606bfe03b45 100644
--- a/starboard/player.h
+++ b/starboard/player.h
@@ -534,7 +534,12 @@ SB_EXPORT void SbPlayerWriteSample2(SbPlayer player,
                                     int number_of_sample_infos);
 
 // Returns the maximum number of samples that can be written in a single call
-// to SbPlayerWriteSamples().
+// to SbPlayerWriteSamples(). Returning a value greater than one can improve
+// performance by allowing SbPlayerWriteSamples() to write multiple samples in
+// one call.
+//
+// Note that this feature is currently disabled in Cobalt where
+// SbPlayerWriteSamples() will always be called with one sample.
 //
 // |player|: The player for which the number is retrieved.
 // |sample_type|: The type of sample for which the number is retrieved. See the