레지스트리 키 개체

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 함수에 DeviceObject 및 SubDevice라는 두 개의 추가 매개 변수가 필요하다는 점을 제외하면 두 호출은 비슷합니다. 자세한 내용은 PcNewRegistryKey를 참조하세요.

미니포트 드라이버가 새 IRegistryKey 개체를 만들 때 개체는 기존 하위 키를 열거나 없는 경우 새 레지스트리 하위 키를 만듭니다. 두 경우 모두 레지스트리 키 개체는 키에 대한 핸들을 저장합니다. 해당 개체가 나중에 릴리스되고 참조 수가 0으로 감소하면 개체가 키에 대한 핸들을 자동으로 닫습니다.

IRegistryKey 인터페이스는 다음 메서드를 지원합니다.

IRegistryKey::D eleteKey

IRegistryKey::EnumerateKey

IRegistryKey::EnumerateValueKey

IRegistryKey::NewSubKey

IRegistryKey::QueryKey

IRegistryKey::QueryRegistryValues

IRegistryKey::QueryValueKey

IRegistryKey::SetValueKey