diff --git a/include/cdio/mmc.h b/include/cdio/mmc.h index b742ccf2..3a6508e5 100644 --- a/include/cdio/mmc.h +++ b/include/cdio/mmc.h @@ -545,7 +545,7 @@ driver_return_code_t mmc_audio_get_volume (CdIo_t *p_cdio, /*out*/ @param p_cdio the CD object to be acted upon. @param track the track you to get ISRC info - @param buf place to put ISRC info + @param p_isrc place to put ISRC info */ driver_return_code_t mmc_isrc_track_read_subchannel (CdIo_t *p_cdio, /*in*/ const track_t track, @@ -755,7 +755,7 @@ driver_return_code_t mmc_audio_get_volume (CdIo_t *p_cdio, /*out*/ about the current state of the drive (e.g. 00h TEST UNIT READY). @param p_cdio CD structure set by cdio_open(). - @param sense returns the sense bytes received from the drive. + @param pp_sense returns the sense bytes received from the drive. This is allocated memory or NULL if no sense bytes are available. Dispose non-NULL pointers by free() when no longer needed. See SPC-3 4.5.3 Fixed format sense data. SCSI error diff --git a/include/cdio/mmc_hl_cmds.h b/include/cdio/mmc_hl_cmds.h index f8e899d9..48d23814 100644 --- a/include/cdio/mmc_hl_cmds.h +++ b/include/cdio/mmc_hl_cmds.h @@ -42,7 +42,7 @@ extern "C" { /** Detects if a disc (CD or DVD) is erasable or not. - @param p_user_data the CD object to be acted upon. + @param p_cdio the CD object to be acted upon. @param b_erasable, if not NULL, on return will be set indicate whether the operation was a success (DRIVER_OP_SUCCESS) or if not to some @@ -70,9 +70,7 @@ extern "C" { @param p_cdio the CD object to be acted upon. - @param i_status, if not NULL, on return will be set indicate whether - the operation was a success (DRIVER_OP_SUCCESS) or if not to some - other value. + @param i_timeout_ms, number of millisections to wait before timeout @param p_disctype the disc type set on success. @return DRIVER_OP_SUCCESS (0) if we got the status. diff --git a/include/cdio/mmc_ll_cmds.h b/include/cdio/mmc_ll_cmds.h index dda71573..12114d32 100644 --- a/include/cdio/mmc_ll_cmds.h +++ b/include/cdio/mmc_ll_cmds.h @@ -44,6 +44,15 @@ extern "C" { /** Get drive capabilities vis SCSI-MMC GET CONFIGURATION @param p_cdio the CD object to be acted upon. + + @param p_buf pointer to location to store mode sense information + + @param i_size number of bytes allocated to p_buf + + @param i_timeout_ms value in milliseconds to use on timeout. Setting + to 0 uses the default time-out value stored in + mmc_timeout_ms. + @return DRIVER_OP_SUCCESS (0) if we got the status. return codes are the same as driver_return_code_t */ @@ -94,8 +103,12 @@ extern "C" { and put the results in p_buf @param p_cdio the CD object to be acted upon. @param p_buf pointer to location to store mode sense information + @param i_size number of bytes allocated to p_buf - @param i_page which "page" of the mode sense command we are interested in + + @param i_page_code which "page" of the mode sense command we are + interested in + @return DRIVER_OP_SUCCESS if we ran the command ok. */ driver_return_code_t mmc_mode_sense_10( CdIo_t *p_cdio, /*out*/ void *p_buf, @@ -119,8 +132,12 @@ extern "C" { SCSI-MMC PREVENT/ALLOW MEDIUM REMOVAL. @param p_cdio the CD object to be acted upon. - @param b_prevent true of drive locked and false if unlocked @param b_persisent make b_prevent state persistent + @param b_prevent true of drive locked and false if unlocked + + @param i_timeout_ms value in milliseconds to use on timeout. Setting + to 0 uses the default time-out value stored in + mmc_timeout_ms. @return DRIVER_OP_SUCCESS (0) if we got the status. return codes are the same as driver_return_code_t