IDiscRecorder2Ex::GetDeviceDescriptor method (imapi2.h)

Retrieves the device descriptor for the device.

Syntax

HRESULT GetDeviceDescriptor(
  [out] BYTE                           **data,
  [out] ULONG_IMAPI2_DEVICE_DESCRIPTOR *byteSize
);

Parameters

[out] data

Data buffer that contains the descriptor of the storage device. For details of the contents of the data buffer, see the STORAGE_DEVICE_DESCRIPTOR structure in the DDK

When done, call the CoTaskMemFree function to free the memory.

[out] byteSize

Size, in bytes, of the data buffer.

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_POINTER	Pointer is not valid. Value: 0x80004003
E_FAIL	Unspecified failure. Value: 0x80004005
E_OUTOFMEMORY	Failed to allocate the required memory. Value: 0x8007000E

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	imapi2.h

See also

IDiscRecorder2Ex