SET_LOCAL_HOST_PROPS3包含定义或标识 1394 主机控制器配置 ROM 中的一个或多个单元目录所需的数据。
语法
typedef struct _SET_LOCAL_HOST_PROPS3 {
ULONG fulFlags;
HANDLE hCromData;
ULONG nLength;
PMDL Mdl;
} SET_LOCAL_HOST_PROPS3, *PSET_LOCAL_HOST_PROPS3;
成员
fulFlags
指定要对SET_LOCAL_HOST_PROPS3结构中包含的单元目录数据执行的作。
| 旗 | 描述 |
|---|---|
| SLHP_FLAG_ADD_CROM_DATA | 指示SET_LOCAL_HOST_PROPS3结构中包含的数据用于在主机控制器的配置 ROM 中创建新的单元目录。 |
| SLHP_FLAG_REMOVE_CROM_DATA | 指示SET_LOCAL_HOST_PROPS3结构中包含的数据用于标识和删除主机控制器配置 ROM 中的现有单元目录。 |
hCromData
包含创建一个或多个单元目录后返回的句柄。 驱动程序必须存储此值，并在删除这些单元目录时将其传递给总线驱动程序。 如果设置了SLHP_FLAG_ADD_CROM_DATA标志，则这是输出参数。 如果设置了SLHP_FLAG_REMOVE_CROM_DATA标志，则这是一个输入参数。
nLength
包含由 Mdl指向的数据缓冲区的长度。
Mdl
指向包含单元目录信息的数据缓冲区的指针。
言论
SET_LOCAL_HOST_PROPS3结构在 REQUEST_SET_LOCAL_HOST_PROPERTIES 请求期间发送到 u.SetLocalHostProperties.Information 成员中的总线驱动程序，u.SetLocalHostProperties.nLevel= SET_LOCAL_HOST_PROPERTIES_MODIFY_CROM。
Mdl 指向的缓冲区的第一个元素必须是单元目录。 后跟请求中定义的任何其他叶或目录的偏移量。 偏移量必须相对于缓冲区的开头。 如果请求导致创建新的单元目录，则总线驱动程序会将指针添加到根目录中新创建的目录。 Mdl 指向的缓冲区必须采用大端数据格式。 如果驱动程序在删除驱动程序时无法删除其动态添加的配置 ROM 数据，则总线驱动程序会自动还原 Configuration ROM 的默认内容。
要求
| 要求 | 价值 |
|---|---|
| 标头 | 1394.h （包括 1394.h） |