DEXT中如何为UserCreateTargetForId()创建的SCSI设备设置属性？

问题背景 #

在KEXT驱动中，我通过Info.plist配置Protocol Characteristics属性可以正常生效：

<key>Protocol Characteristics</key>
<dict>
    <key>Physical Interconnect</key>
    <string>SAS</string>
    <key>Physical Interconnect Location</key>
    <string>External</string>
</dict>

但同样的方法在DEXT驱动中完全无效，我的SCSI设备的Protocol Characteristics依然显示为默认值：

<dict>
    <key>Physical Interconnect</key>
    <string>SCSI Parallel Interface</string>
    <key>Physical Interconnect Location</key>
    <string>Internal/External</string>
</dict>

我尝试过通过UserCreateTargetForId()的第二个参数传递这些属性，但也没有效果。请问该如何在DEXT中正确设置这个属性？

解决方案 #

DEXT基于DriverKit框架，和传统KEXT的配置逻辑完全不同，无法通过Info.plist直接设置这类设备动态属性，必须在驱动代码中通过API主动设置：

1. 确认驱动类继承关系
   确保你的DEXT驱动类继承自IOSCSITargetProvider（或其派生类），这是SCSI目标设备驱动的核心基类。

2. 在代码中动态设置属性
   在驱动的Start方法（或设备初始化完成后的合适时机）中，创建属性字典并设置对应键值，再通过SetProperties方法应用到目标对象：

   // 示例Objective-C代码
   - (IOReturn)Start {
       IOReturn ret = [super Start];
       if (ret != kIOReturnSuccess) {
           return ret;
       }
   
       // 创建属性字典
       NSDictionary *props = @{
           kIOPropertyPhysicalInterconnectKey: @"SAS",
           kIOPropertyPhysicalInterconnectLocationKey: @"External"
       };
   
       // 将属性应用到当前目标设备
       ret = [self SetProperties:props];
       if (ret != kIOReturnSuccess) {
           OSLogError(logHandle, "Failed to set protocol characteristics: %d", ret);
       }
   
       return ret;
   }
   

3. 关于UserCreateTargetForId()的注意点
   如果使用UserCreateTargetForId()创建目标，需要确保传递的属性字典包含正确的Core Foundation键（而非Info.plist中的字符串键）：

   CFDictionaryRef props = CFDictionaryCreate(kCFAllocatorDefault,
       (const void **)&kIOPropertyPhysicalInterconnectKey,
       (const void **)&CFSTR("SAS"),
       1,
       &kCFTypeDictionaryKeyCallBacks,
       &kCFTypeDictionaryValueCallBacks);
   // 补充Location键后再传递给UserCreateTargetForId
   

   若创建时设置无效，建议在目标创建完成后，再调用SetProperties方法补设属性。

4. 验证属性生效
   设置完成后，可以通过ioreg命令查看设备属性，确认Protocol Characteristics是否已更新：

   ioreg -l | grep -A 10 "Protocol Characteristics"
   

内容的提问来源于stack exchange，提问作者Alex