共用方式為


登錄機碼物件

PortCls 系統驅動程式會實作 IRegistryKey 介面,以取得迷你埠驅動程式的優點。 IRegistryKey 物件代表登錄機碼。 迷你埠驅動程式會使用登錄機碼物件來執行下列動作:

  • 建立和刪除登錄機碼

  • 列舉登錄機碼

  • 查詢和設定登錄機碼

查詢登錄機碼物件以取得指定機碼下登錄專案的相關資訊時,查詢可以輸出三種格式之一的資訊,每個格式都會使用不同的機碼查詢結構。 下表顯示 KEY_INFORMATION_CLASS 列舉值,指出查詢輸出三個索引鍵查詢結構的哪一個。

KEY_INFORMATION_CLASS值 Key-Query 結構

KeyBasicInformation

KEY_BASIC_INFORMATION

KeyFullInformation

KEY_FULL_INFORMATION

KeyNodeInformation

KEY_NODE_INFORMATION

若要開啟現有的登錄機碼或建立新的登錄機碼,配接器驅動程式可以呼叫 PcNewRegistryKey 函式,而迷你埠驅動程式可以呼叫埠驅動程式的 IPort::NewRegistryKey 方法。 這兩個呼叫很類似,不同之處在于 PcNewRegistryKey 函式需要兩個額外的參數 DeviceObjectSubDevice。 如需詳細資訊,請參閱 PcNewRegistryKey

當迷你埠驅動程式建立新的 IRegistryKey 物件時 ,物件會開啟現有的子機碼,如果不存在,則會建立新的登錄子機碼。 不論是哪一種情況,登錄機碼物件會儲存金鑰的控制碼。 當該物件稍後釋出且其參考計數遞減為零時,物件會自動將其控制碼關閉至索引鍵。

IRegistryKey介面支援下列方法:

IRegistryKey::D eleteKey

IRegistryKey::EnumerateKey

IRegistryKey::EnumerateValueKey

IRegistryKey::NewSubKey

IRegistryKey::QueryKey

IRegistryKey::QueryRegistryValues

IRegistryKey::QueryValueKey

IRegistryKey::SetValueKey