登錄機碼物件
PortCls 系統驅動程式會實作 IRegistryKey 介面,以取得迷你埠驅動程式的優點。 IRegistryKey 物件代表登錄機碼。 迷你埠驅動程式會使用登錄機碼物件來執行下列動作:
建立和刪除登錄機碼
列舉登錄機碼
查詢和設定登錄機碼
查詢登錄機碼物件以取得指定機碼下登錄專案的相關資訊時,查詢可以輸出三種格式之一的資訊,每個格式都會使用不同的機碼查詢結構。 下表顯示 KEY_INFORMATION_CLASS 列舉值,指出查詢輸出三個索引鍵查詢結構的哪一個。
KEY_INFORMATION_CLASS值 | Key-Query 結構 |
---|---|
KeyBasicInformation |
|
KeyFullInformation |
|
KeyNodeInformation |
若要開啟現有的登錄機碼或建立新的登錄機碼,配接器驅動程式可以呼叫 PcNewRegistryKey 函式,而迷你埠驅動程式可以呼叫埠驅動程式的 IPort::NewRegistryKey 方法。 這兩個呼叫很類似,不同之處在于 PcNewRegistryKey 函式需要兩個額外的參數 DeviceObject 和 SubDevice。 如需詳細資訊,請參閱 PcNewRegistryKey。
當迷你埠驅動程式建立新的 IRegistryKey 物件時 ,物件會開啟現有的子機碼,如果不存在,則會建立新的登錄子機碼。 不論是哪一種情況,登錄機碼物件會儲存金鑰的控制碼。 當該物件稍後釋出且其參考計數遞減為零時,物件會自動將其控制碼關閉至索引鍵。
IRegistryKey介面支援下列方法:
IRegistryKey::EnumerateValueKey