DEVICE_REGISTRY_PROPERTY 列挙体は、レジストリに格納されているデバイス のプロパティを識別します。
構文
typedef enum {
DevicePropertyDeviceDescription,
DevicePropertyHardwareID,
DevicePropertyCompatibleIDs,
DevicePropertyBootConfiguration,
DevicePropertyBootConfigurationTranslated,
DevicePropertyClassName,
DevicePropertyClassGuid,
DevicePropertyDriverKeyName,
DevicePropertyManufacturer,
DevicePropertyFriendlyName,
DevicePropertyLocationInformation,
DevicePropertyPhysicalDeviceObjectName,
DevicePropertyBusTypeGuid,
DevicePropertyLegacyBusType,
DevicePropertyBusNumber,
DevicePropertyEnumeratorName,
DevicePropertyAddress,
DevicePropertyUINumber,
DevicePropertyInstallState,
DevicePropertyRemovalPolicy,
DevicePropertyResourceRequirements,
DevicePropertyAllocatedResources,
DevicePropertyContainerID
} DEVICE_REGISTRY_PROPERTY;
定数
DevicePropertyDeviceDescriptionデバイスを記述する文字列 ("Microsoft PS/2 ポート マウス" など)、通常は製造元によって定義されます。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyHardwareIDハードウェア ID デバイスを識別するデバイスによって提供されます。 プロパティ型はREG_MULTI_SZ値です。 |
DevicePropertyCompatibleIDs互換性のある ID デバイスによって報告されます。 プロパティ型はREG_MULTI_SZ値です。 |
DevicePropertyBootConfigurationファームウェアによってデバイスに割り当てられたハードウェア リソース (未加工の形式)。 プロパティ型は CM_RESOURCE_LIST 構造体です。 |
DevicePropertyBootConfigurationTranslatedファームウェアによってデバイスに割り当てられたハードウェア リソース (変換形式)。 プロパティ型は CM_RESOURCE_LIST 構造体です。 |
DevicePropertyClassNameデバイスのセットアップ クラスの名前 (テキスト形式)。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyClassGuidデバイスのセットアップ クラスの GUID。 プロパティ型は、WCHAR の NULL で終わる配列です。 次のような文字列形式の GUID。各 "c" は 16 進数の文字を表します: {cccccccc-cccc-cccc-cccccccccc} |
DevicePropertyDriverKeyNameドライバー固有のレジストリ キーの名前。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyManufacturerデバイスの製造元を識別する文字列。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyFriendlyName2 つの類似したデバイスを区別するために使用できる文字列。通常はクラス インストーラーによって定義されます。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyLocationInformationバス上のデバイスの場所に関する情報。この情報の解釈はバス固有です。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyPhysicalDeviceObjectNameこのデバイスの PDO の名前。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyBusTypeGuidデバイスが接続されているバスの GUID。 システム定義のバス・タイプ GUID は、 Wdmguid.h・ヘッダー・ファイルにリストされます。 プロパティ型は GUID であり、バイナリ形式の GUID を含む 16 バイトの構造体です。 |
DevicePropertyLegacyBusTypePCIBus や PCMCIABus などのバスの種類を要求します。 プロパティ型は、INTERFACE_TYPE 列挙値です。 |
DevicePropertyBusNumberデバイスが接続されているバスのレガシ バス番号。 プロパティの種類は ULONG です。 |
DevicePropertyEnumeratorNameデバイスの列挙子の名前 ("PCI" や "root" など)。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
DevicePropertyAddressバス上のデバイスのアドレス。 プロパティの種類は ULONG です。 このアドレスの解釈はバス固有です。 このルーチンの呼び出し元は、DevicePropertyBusTypeGuid(場合によっては DevicePropertyLegacyBusType) を要求するためにルーチンを再度呼び出して、アドレスを解釈できるようにする必要があります。 0xFFFFFFFFのアドレス値は、基になるバス ドライバーがデバイスのバス アドレスを指定しなかったことを示します。 バス ドライバー固有の追加情報については、「 解説 」を参照してください。 |
DevicePropertyUINumberユーザー インターフェイスに表示できるデバイスに関連付けられている番号。 プロパティ型は ULONG 値です。 通常、この番号は、ボード上のスロットの横に印刷される番号や、ユーザーが物理デバイスを見つけやすくするその他の番号など、ユーザーが認識するスロット番号です。 デバイスが UI 番号規則のないバス上にある場合、またはデバイスのバス ドライバーが UI 番号を判断できない場合、この値は0xFFFFFFFF。 |
DevicePropertyInstallStateデバイスのインストール状態。 プロパティ型は、DEVICE_INSTALL_STATE 列挙値です。 |
DevicePropertyRemovalPolicyデバイスの現在の削除ポリシー。 オペレーティング システムでは、この値をヒントとして使用して、デバイスが通常どのように削除されるかを判断します。 プロパティ型は、DEVICE_REMOVAL_POLICY 列挙値です。 |
DevicePropertyResourceRequirementsデバイスのリソース要件。 プロパティ型は IO_RESOURCE_REQUIREMENTS_LIST 構造体です。 |
DevicePropertyAllocatedResourcesデバイスに割り当てられたリソース。 プロパティ型は CM_RESOURCE_LIST 構造体です。 |
DevicePropertyContainerIDデバイスのコンテナー ID。 プロパティ型は NULL で終わる WCHAR 文字列です。 |
注釈
DevicePropertyAddress 値については、次の一覧に、特定のバス ドライバーが子デバイス用に格納する情報について説明します。
| バス | 形容 |
|---|---|
| 1394 | アドレスは揮発性であるため、アドレスを指定しません。 既定値は 0xFFFFFFFF です。 |
| EISA | スロット番号 (0 から F)。 |
| 井手 | IDE デバイスの場合、アドレスにはターゲット ID と LUN が含まれます。 IDE チャネルの場合、アドレスは 0 または 1 です (0 = プライマリ チャネル、1 = セカンダリ チャネル)。 |
| ISApnp | アドレスを指定しません。 既定値は 0xFFFFFFFF です。 |
| PC カード (PCMCIA) | ソケット番号 (通常は0x00または0x40)。 |
| PCI | 高い単語のデバイス番号と低い単語の関数番号。 |
| SCSI | ターゲット ID。 |
| USB | ポート番号。 |
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h を含む) |