IDiscFormat2Data::get_SupportedWriteSpeeds Method
Retrieves a list of the write speeds supported by the disc recorder and current media.
http://msdn.microsoft.com/en-us/library/aa364880(VS.85).aspx
Syntax
C++
HRESULT get_SupportedWriteSpeeds(
[out] SAFEARRAY *supportedSpeeds
);
Parameters
supportedSpeeds [out]
-
List of the write speeds supported by the disc recorder and current media. Each element of the array is a VARIANT of type VT_UI4. The ulVal member of the variant contains the number of sectors written per second.
Return Value
S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:
Return code Description
E_IMAPI_RECORDER_REQUIRED
The request requires a current disc recorder to be selected.
Value: 0xC0AA0003
E_INVALIDARG
One or more arguments are not valid.
Value: 0x80070057
E_POINTER
Pointer is not valid.
Note This value does not indicate a NULL pointer.
Value: 0x80004003
E_FAIL
Unspecified failure.
Value: 0x80004005
E_OUTOFMEMORY
Failed to allocate the required memory.
Value: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT
The device failed to accept the command within the timeout period. This may be caused by the device having entered an inconsistent state, or the timeout value for the command may need to be increased.
Value: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE
The device reported unexpected or invalid data for a command.
Value: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN
The media is inserted upside down.
Value: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY
The drive reported that it is in the process of becoming ready. Please try the request again later.
Value: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA
There is no media in the device.
Value: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS
The media is currently being formatted. Please wait for the format to complete before attempting to use the media.
Value: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY
The drive reported that it is performing a long-running operation, such as finishing a write. The drive may be unusable for a long period of time.
Value: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING
The write failed because the drive did not receive data quickly enough to continue writing. Moving the source data to the local computer, reducing the write speed, or enabling a "buffer underrun free" setting may resolve this issue.
Value: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE
The media is not compatible or of unknown physical format.
Value: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT
The device failed to accept the command within the timeout period. This may be caused by the device having entered an inconsistent state, or the timeout value for the command may need to be increased.
Value: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE
The device reported that the requested mode page (and type) is not present.
Value: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS
The drive reported that the combination of parameters provided in the mode page for a MODE SELECT command were not supported.
Value: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED
The drive reported that the media is write protected.
Value: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH
The media's speed is incompatible with the device. This may be caused by using higher or lower speed media than the range of speeds supported by the device.
Value: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
The specified handle is invalid.
Value: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
The specified network resource or device is no longer available.
Value: 55
E_IMAPI_RECORDER_LOCKED
The device associated with this recorder during the last operation has been exclusively locked, causing this operation to failed.
Value: 0xC0AA0210
E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE
The write failed because the drive returned error information that could not be recovered from.
Value: 0xC0AA0301
Remarks
You can use a speed from the list to set the write speed when calling the IDiscFormat2Data::SetWriteSpeed method.
To retrieve a list of the write configurations that the recorder and current media supports, call the IDiscFormat2Data::get_SupportedWriteSpeedDescriptors method.
Requirements
Minimum supported client
Windows Vista, Windows XP with SP2 Minimum supported server
Windows Server 2003 IDL
Imapi2.idl
Retrieves a list of the write speeds supported by the disc recorder and current media.
http://msdn.microsoft.com/en-us/library/aa364880(VS.85).aspx
Syntax
HRESULT get_SupportedWriteSpeeds(
[out] SAFEARRAY *supportedSpeeds
);
Parameters
-
supportedSpeeds [out]
-
List of the write speeds supported by the disc recorder and current media. Each element of the array is a VARIANT of type VT_UI4. The ulVal member of the variant contains the number of sectors written per second.
Return Value
S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:
Return code | Description |
---|---|
| The request requires a current disc recorder to be selected. Value: 0xC0AA0003 |
| One or more arguments are not valid. Value: 0x80070057 |
| Pointer is not valid. Note This value does not indicate a NULL pointer. Value: 0x80004003 |
| Unspecified failure. Value: 0x80004005 |
| Failed to allocate the required memory. Value: 0x8007000E |
| The device failed to accept the command within the timeout period. This may be caused by the device having entered an inconsistent state, or the timeout value for the command may need to be increased. Value: 0xC0AA020D |
| The device reported unexpected or invalid data for a command. Value: 0xC0AA02FF |
| The media is inserted upside down. Value: 0xC0AA0204 |
| The drive reported that it is in the process of becoming ready. Please try the request again later. Value: 0xC0AA0205 |
| There is no media in the device. Value: 0xC0AA0202 |
| The media is currently being formatted. Please wait for the format to complete before attempting to use the media. Value: 0xC0AA0206 |
| The drive reported that it is performing a long-running operation, such as finishing a write. The drive may be unusable for a long period of time. Value: 0xC0AA0207 |
| The write failed because the drive did not receive data quickly enough to continue writing. Moving the source data to the local computer, reducing the write speed, or enabling a "buffer underrun free" setting may resolve this issue. Value: 0xC0AA0300 |
| The media is not compatible or of unknown physical format. Value: 0xC0AA0203 |
| The device failed to accept the command within the timeout period. This may be caused by the device having entered an inconsistent state, or the timeout value for the command may need to be increased. Value: 0xC0AA020E |
| The device reported that the requested mode page (and type) is not present. Value: 0xC0AA0201 |
| The drive reported that the combination of parameters provided in the mode page for a MODE SELECT command were not supported. Value: 0xC0AA0208 |
| The drive reported that the media is write protected. Value: 0xC0AA0209 |
| The media's speed is incompatible with the device. This may be caused by using higher or lower speed media than the range of speeds supported by the device. Value: 0xC0AA020F |
| The specified handle is invalid. Value: 6 |
| The specified network resource or device is no longer available. Value: 55 |
| The device associated with this recorder during the last operation has been exclusively locked, causing this operation to failed. Value: 0xC0AA0210 |
| The write failed because the drive returned error information that could not be recovered from. Value: 0xC0AA0301 |
Remarks
You can use a speed from the list to set the write speed when calling the IDiscFormat2Data::SetWriteSpeed method.
To retrieve a list of the write configurations that the recorder and current media supports, call the IDiscFormat2Data::get_SupportedWriteSpeedDescriptors method.
Requirements
Minimum supported client | Windows Vista, Windows XP with SP2 |
---|---|
Minimum supported server | Windows Server 2003 |
IDL | Imapi2.idl |