IDiscRecorder2Ex：：ReadDvdStructure 方法 (imapi2.h)
从媒体读取 DVD 结构。
语法
HRESULT ReadDvdStructure(
[in] ULONG format,
[in] ULONG address,
[in] ULONG layer,
[in] ULONG agid,
[out] BYTE **data,
[out] ULONG_IMAPI2_DVD_STRUCTURE *count
);
参数
[in] format
命令数据包的格式字段。 可接受的值范围为 0 到 0xFF。
[in] address
命令数据包的地址字段。
[in] layer
命令数据包的层字段。
[in] agid
命令数据包的 AGID) 字段中 (身份验证授权 ID。
[out] data
包含 DVD 结构的数据缓冲区。 有关数据缓冲区内容的详细信息，请参阅 ftp://ftp.t10.org/t10/drafts/mmc5 上 MMC 规范的最新修订版中的 READ DISC STRUCTURE 命令。
此方法从缓冲区中删除标头。
完成后，调用 CoTaskMemFree 函数以释放内存。
[out] count
数据缓冲区的大小（以字节为单位）。
返回值
成功后返回S_OK，但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：
| 返回代码 | 说明 |
|---|---|
|
指针无效。
值：0x80004003 |
|
未知故障。
值：0x80004005 |
|
驱动器不支持 GET CONFIGURATION 命令。
值：0xC0AA020C |
|
设备不支持请求的功能页。
值：0xC0AA020A |
|
未能分配所需的内存。
值：0x8007000E |
|
支持请求的功能页，但未标记为当前。
值：0xC0AA020B |
|
设备未能在超时期限内接受该命令。 这可能是由于设备进入了不一致状态，或者可能需要增加命令的超时值。
值：0xC0AA020D |
|
设备报告了命令的意外或无效数据。
值：0xC0AA02FF |
|
媒体是倒置插入的。
值：0xC0AA0204 |
|
驱动器报告它正在准备就绪。 请稍后重试请求。
值：0xC0AA0205 |
|
设备中没有媒体。
值：0xC0AA0202 |
|
媒体当前正在格式化。 请在尝试使用媒体之前等待格式完成。
值：0xC0AA0206 |
|
驱动器报告它正在执行长时间运行的操作，例如完成写入。 驱动器可能长时间不可用。
值：0xC0AA0207 |
|
写入失败，因为驱动器接收数据的速度不够快，无法继续写入。 将源数据移动到本地计算机、降低写入速度或启用“缓冲区不足可用”设置可以解决此问题。
值：0xC0AA0300 |
|
媒体不兼容或物理格式未知。
值：0xC0AA0203 |
|
DVD 结构不存在。 这可能是由于使用的驱动器/介质不兼容导致的。
值：0xC0AA020E |
|
设备报告请求的模式页 (，并且不存在类型) 。
值：0xC0AA0201 |
|
驱动器报告不支持 MODE SELECT 命令的模式页中提供的参数组合。
值：0xC0AA0208 |
|
驱动器报告介质受到写入保护。
值：0xC0AA0209 |
|
媒体的速度与设备不兼容。 这可能是由于使用高于或低于设备支持的速度范围的媒体造成的。
值：0xC0AA020F |
|
指定的句柄无效。
值：6 |
|
指定的网络资源或设备不再可用。
值：55 |
|
上次操作期间与此记录器关联的设备已被独占锁定，导致此操作失败。
值：0xC0AA0210 |
|
设备未能在超时期限内接受命令。 这可能是由于设备进入了不一致状态，或者可能需要增加命令的超时值。
值：0xC0AA020E |
注解
此方法消除了使用 READ DISC STRUCTURE 命令的复杂性。 有关要为 格式、 地址、 层和 agid 参数指定的值的详细信息，请参阅 FTP://FTP.T10.ORG/T10/DRAFTS/MMC5 中有关 MMC 规范最新版本中 READ DISC STRUCTURE 命令的字段说明。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista、Windows XP 和 SP2 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | imapi2.h |