IO_RESOURCE_DESCRIPTOR 構造体 (wdm.h)

[アーティクル]
03/08/2023

IO_RESOURCE_DESCRIPTOR構造体は、デバイスで使用できる 1 種類の生のハードウェアリソースの範囲を表します。 IO_RESOURCE_DESCRIPTOR構造体の配列は、各IO_RESOURCE_LIST構造体内に格納されます。

構文

typedef struct _IO_RESOURCE_DESCRIPTOR {
  UCHAR  Option;
  UCHAR  Type;
  UCHAR  ShareDisposition;
  UCHAR  Spare1;
  USHORT Flags;
  USHORT Spare2;
  union {
    struct {
      ULONG            Length;
      ULONG            Alignment;
      PHYSICAL_ADDRESS MinimumAddress;
      PHYSICAL_ADDRESS MaximumAddress;
    } Port;
    struct {
      ULONG            Length;
      ULONG            Alignment;
      PHYSICAL_ADDRESS MinimumAddress;
      PHYSICAL_ADDRESS MaximumAddress;
    } Memory;
    struct {
      ULONG             MinimumVector;
      ULONG             MaximumVector;
#if ...
      IRQ_DEVICE_POLICY AffinityPolicy;
      USHORT            Group;
#else
      IRQ_DEVICE_POLICY AffinityPolicy;
#endif
      IRQ_PRIORITY      PriorityPolicy;
      KAFFINITY         TargetedProcessors;
    } Interrupt;
    struct {
      ULONG MinimumChannel;
      ULONG MaximumChannel;
    } Dma;
    struct {
      ULONG RequestLine;
      ULONG Reserved;
      ULONG Channel;
      ULONG TransferWidth;
    } DmaV3;
    struct {
      ULONG            Length;
      ULONG            Alignment;
      PHYSICAL_ADDRESS MinimumAddress;
      PHYSICAL_ADDRESS MaximumAddress;
    } Generic;
    struct {
      ULONG Data[3];
    } DevicePrivate;
    struct {
      ULONG Length;
      ULONG MinBusNumber;
      ULONG MaxBusNumber;
      ULONG Reserved;
    } BusNumber;
    struct {
      ULONG Priority;
      ULONG Reserved1;
      ULONG Reserved2;
    } ConfigData;
    struct {
      ULONG            Length40;
      ULONG            Alignment40;
      PHYSICAL_ADDRESS MinimumAddress;
      PHYSICAL_ADDRESS MaximumAddress;
    } Memory40;
    struct {
      ULONG            Length48;
      ULONG            Alignment48;
      PHYSICAL_ADDRESS MinimumAddress;
      PHYSICAL_ADDRESS MaximumAddress;
    } Memory48;
    struct {
      ULONG            Length64;
      ULONG            Alignment64;
      PHYSICAL_ADDRESS MinimumAddress;
      PHYSICAL_ADDRESS MaximumAddress;
    } Memory64;
    struct {
      UCHAR Class;
      UCHAR Type;
      UCHAR Reserved1;
      UCHAR Reserved2;
      ULONG IdLowPart;
      ULONG IdHighPart;
    } Connection;
  } u;
} IO_RESOURCE_DESCRIPTOR, *PIO_RESOURCE_DESCRIPTOR;

メンバー

Option

このリソースの説明を必須、優先、または代替のいずれにするかを指定します。次のいずれかの値を使用する必要があります。

値	意味
0	別の範囲も指定しない限り、指定されたリソース範囲が必要です。
IO_RESOURCE_PREFERRED	指定したリソース範囲は、任意の代替範囲より優先されます。
IO_RESOURCE_ALTERNATIVE	指定したリソース範囲は、その前の範囲に代わるものになります。たとえば、1 つの IO_RESOURCE_DESCRIPTOR 構造体で IRQ 5 が指定され、IO_RESOURCE_PREFERREDが設定され、次の構造体で IRQ 3 が指定IO_RESOURCE_ALTERNATIVE場合、PnP マネージャーは IRQ 5 が使用できない場合にのみ IRQ 3 をデバイスに割り当てます。リソースごとに複数の代替手段を指定できます。 IO_RESOURCE_ALTERNATIVEとIO_RESOURCE_PREFERREDの両方を設定でき、推奨される代替手段を示します。
IO_RESOURCE_DEFAULT	使用されていません。

Type

リソースの種類を識別します。有効な値の一覧については、CM_PARTIAL_RESOURCE_DESCRIPTOR構造体の Type メンバーを参照してください。

ShareDisposition

説明されているリソースを共有できるかどうかを示します。有効な値の一覧については、CM_PARTIAL_RESOURCE_DESCRIPTOR構造体の ShareDisposition メンバーを参照してください。

Spare1

使用されていません。

Flags

リソースの種類に固有のビットフラグが含まれています。次の表は、 Type = CmResourceTypeInterrupt の場合に有効なフラグを示しています。

値	意味
CM_RESOURCE_INTERRUPT_LEVEL_SENSITIVE	IRQ 行はレベルによってトリガーされます。 (これらの IRQ は通常共有可能です)。
CM_RESOURCE_INTERRUPT_LATCHED	IRQ ラインはエッジトリガーされます。
CM_RESOURCE_INTERRUPT_MESSAGE	このフラグが設定されている場合、割り込みはメッセージシグナル割り込みになります。それ以外の場合、割り込みは行ベースの割り込みになります。
CM_RESOURCE_INTERRUPT_POLICY_INCLUDED	このフラグが設定されている場合、u.Interrupt メンバーには、デバイスの割り込みポリシーを記述するデータが含まれます。
CM_RESOURCE_INTERRUPT_SECONDARY_INTERRUPT	割り込みは、低電力アイドル状態またはシステムスリープ状態からオペレーティングシステムをスリープ解除できます。このフラグは、Windows 8 以降で設定できます。ウェイク機能の詳細については、「デバイスのウェイクアップを有効にする」を参照してください。
CM_RESOURCE_INTERRUPT_WAKE_HINT	割り込みは、低電力アイドル状態またはシステムスリープ状態からオペレーティングシステムをスリープ解除できます。このフラグは、Windows 8 以降で設定できます。ウェイク機能の詳細については、「デバイスのウェイクアップを有効にする」を参照してください。

その他のリソースの種類の有効なフラグの一覧については、CM_PARTIAL_RESOURCE_DESCRIPTOR構造体の Flags メンバーの説明を参照してください。

Spare2

使用されていません。

u

u 共用体を定義します。

u.Port

次のメンバーを使用して、I/O ポートアドレスの範囲を指定します。

ドライバーは、このメンバーを直接更新するのではなく、 RtlIoDecodeMemIoResource と RtlIoEncodeMemIoResource を使用してこのメンバーを読み取って更新する必要があります。

u.Port.Length

割り当て可能な I/O ポートアドレスの範囲の長さ (バイト単位)。

u.Port.Alignment

割り当てられた開始アドレスが準拠する必要があるアラインメント (バイト単位)。割り当てられた開始アドレスは、 Alignment の整数倍数である必要があります。

u.Port.MinimumAddress

デバイスに割り当てることができる最小バス相対 I/O ポートアドレス。

u.Port.MaximumAddress

デバイスに割り当てることができる最大バス相対 I/O ポートアドレス。

u.Memory

次のメンバーを使用して、メモリアドレスの範囲を指定します。

Windows Vista 以降のバージョンの Windows オペレーティングシステムのドライバーでは、直接更新するのではなく、 RtlIoDecodeMemIoResource と RtlIoEncodeMemIoResource を使用してこのメンバーの読み取りと更新を行う必要があります。

u.Memory.Length

割り当て可能なメモリアドレスの範囲の長さ (バイト単位)。

u.Memory.Alignment

u.Memory.MinimumAddress

デバイスに割り当てることができる最小バス相対メモリアドレス。

u.Memory.MaximumAddress

デバイスに割り当てることができる最大バス相対メモリアドレス。

u.Interrupt

次のメンバーを使用して、割り込みベクトル範囲を指定します。

u.Interrupt.MinimumVector

デバイスに割り当てることができる最小バス相対ベクトル。

u.Interrupt.MaximumVector

デバイスに割り当てることができる最大バス相対ベクトル。

CM_RESOURCE_INTERRUPT_MESSAGE フラグビットが設定されている場合、MinimumVector メンバーと MaximumVector メンバーの値には特別な意味があります。詳細については、「割り込みリソース記述子の使用」を参照してください。

このシステムは、Windows Vista 以降のバージョンの Windows オペレーティングシステムで、次の追加メンバーを提供します。

u.Interrupt.AffinityPolicy

システムがプロセッサ間でデバイスの割り込みを分散させる方法を示すIRQ_DEVICE_POLICY値を指定します。

u.Interrupt.Group

プロセッサグループ番号を指定します。 Group は、Windows 7 以降のバージョンの Windows でのみ u.Interrupt の有効で省略可能なメンバーです。このメンバーは、コンパイル時にNT_PROCESSOR_GROUPSが定義されている場合にのみ存在します。 グループ メンバーが存在する場合、Group メンバーと TargetedProcessors メンバーは、デバイスの割り込みを処理するプロセッサのセットを識別するグループアフィニティを指定します。特定のグループのアフィニティを指定するには、 AffinityPolicy を IrqPolicySpecifiedProcessors に設定し、 Group を 適切なグループ番号に設定します。さらに、 TargetedProcessors は 、グループ内のターゲットプロセッサを指定する必要があります。 AffinityPolicy を IrqPolicySpecifiedProcessors 以外の値に設定する場合は、ドライバーがグループ対応であることを示す (つまり、プロセッサグループに関する情報を処理するように設計されている) ことを示すには、Group を ALL_PROCESSOR_GROUPS に設定します。 グループが ALL_PROCESSOR_GROUPS と等しい場合、ドライバーはターゲットプロセッサを指定できません。このようなターゲット指定は無視されます。

u.Interrupt.PriorityPolicy

システムがデバイスの割り込みをディスパッチする優先度を示すIRQ_PRIORITY値を指定します。

u.Interrupt.TargetedProcessors

デバイスの割り込みを処理するプロセッサを示す KAFFINITY 値を指定します。この値は、AffinityPolicy が IrqPolicySpecifiedProcessors の場合にのみ使用されます。

u.Dma

次のいずれかのメンバーを使用して、DMA 設定を指定します。

u.Dma.MinimumChannel

デバイスに割り当てることができる最小バス相対 DMA チャネル。

u.Dma.MaximumChannel

デバイスに割り当てることができる最大バス相対 DMA チャネル。

u.DmaV3

DMA_OPERATIONS構造体のバージョン 3 を使用するドライバーの DMA 設定を指定します。

u.DmaV3 メンバーは、Windows 8 以降で使用できます。

u.DmaV3.RequestLine

デバイスに割り当てられているシステム DMA コントローラー上の要求行の番号。

u.DmaV3.Reserved

使用されていません。

u.DmaV3.Channel

デバイスに割り当てられているシステム DMA コントローラー上の DMA チャネルの番号。

u.DmaV3.TransferWidth

デバイスに割り当てられたシステム DMA コントローラーがデバイスとの間でデータを転送するために使用するデータバスの幅をビット単位で指定します。

u.Generic

使用しません。

u.Generic.Length

使用しません。

u.Generic.Alignment

使用しません。

u.Generic.MinimumAddress

使用しません。

u.Generic.MaximumAddress

使用しません。

u.DevicePrivate

システムで使用するために予約されています。

u.DevicePrivate.Data[3]

システムで使用するために予約されています。

u.BusNumber

次のメンバーを使用してバス番号を指定します。

u.BusNumber.Length

必要なバス番号の数。

u.BusNumber.MinBusNumber

デバイスに割り当てることができる最小バス相対バス番号。

u.BusNumber.MaxBusNumber

デバイスに割り当てることができるバス相対バスの最大数。

u.BusNumber.Reserved

使用されていません。

u.ConfigData

システムで使用するために予約されています。

u.ConfigData.Priority

ULONG メンバーの優先度を定義します。

u.ConfigData.Reserved1

使用しません。

u.ConfigData.Reserved2

使用しません。

u.Memory40

次のメンバーを使用して、メモリアドレスの範囲を指定します。

u.Memory40 メンバーは、Windows Vista 以降のバージョンの Windows オペレーティングシステムでのみ使用できます。これらのバージョンの Windows 用ドライバーでは、このメンバーを直接更新するのではなく、 RtlIoDecodeMemIoResource と RtlIoEncodeMemIoResource を使用してこのメンバーを読み取って更新する必要があります。

u.Memory40.Length40

割り当て可能なメモリアドレスの範囲の 40 ビット長の上位 32 ビット (バイト単位)。下位 8 ビットは 0 として扱われます。

u.Memory40.Alignment40

割り当てられた開始アドレスが準拠する必要がある 40 ビットアラインメントの上位 32 ビット (バイト単位)。下位 8 ビットは 0 として扱われます。割り当てられた開始アドレスは、アラインメントの倍数になります。

u.Memory40.MinimumAddress

デバイスに割り当てることができる最小バス相対メモリアドレス。

u.Memory40.MaximumAddress

デバイスに割り当てることができる最大バス相対メモリアドレス。

u.Memory48

次のメンバーを使用して、メモリアドレスの範囲を指定します。

u.Memory48 メンバーは、Windows Vista 以降のバージョンの Windows オペレーティングシステムでのみ使用できます。これらのバージョンの Windows 用ドライバーでは、このメンバーを直接更新するのではなく、 RtlIoDecodeMemIoResource と RtlIoEncodeMemIoResource を使用してこのメンバーを読み取って更新する必要があります。

u.Memory48.Length48

割り当て可能なメモリアドレスの範囲の 48 ビット長の上位 32 ビット (バイト単位)。下位 16 ビットは 0 として扱われます。

u.Memory48.Alignment48

割り当てられた開始アドレスが準拠する必要がある 48 ビットアラインメントの上位 32 ビット (バイト単位)。下位 16 ビットは 0 として扱われます。割り当てられた開始アドレスは、アラインメントの倍数になります。

u.Memory48.MinimumAddress

デバイスに割り当てることができる最小バス相対メモリアドレス。

u.Memory48.MaximumAddress

デバイスに割り当てることができる最大バス相対メモリアドレス。

u.Memory64

次のメンバーを使用して、メモリアドレスの範囲を指定します。

u.Memory64 メンバーは、Windows Vista 以降のバージョンの Windows オペレーティングシステムでのみ使用できます。 Windows Vista 以降のバージョンの Windows オペレーティングシステム用ドライバーでは、直接更新するのではなく、 RtlIoDecodeMemIoResource と RtlIoEncodeMemIoResource を使用してこのメンバーを読み取って更新する必要があります。

u.Memory64.Length64

割り当て可能なメモリアドレスの範囲の 64 ビット長の上位 32 ビット (バイト単位)。下位 32 ビットは 0 として扱われます。

u.Memory64.Alignment64

割り当てられた開始アドレスが準拠する必要がある 64 ビットアラインメントの上位 32 ビット (バイト単位)。下位 32 ビットは 0 として扱われます。割り当てられた開始アドレスは、アラインメントの倍数になります。

u.Memory64.MinimumAddress

デバイスに割り当てることができる最小バス相対メモリアドレス。

u.Memory64.MaximumAddress

デバイスに割り当てることができる最大バス相対メモリアドレス。

u.Connection

シリアルバスまたはシリアルポート、または 1 つ以上の汎用 I/O (GPIO) ピンのセットへの接続を指定します。

u.Connection メンバーは、Windows 8 以降で使用できます。

次のメンバーは、この接続について説明します。

u.Connection.Class

接続クラス。このメンバーは、次のいずれかの値に設定されます。

値	意味
CM_RESOURCE_CONNECTION_CLASS_GPIO	GPIO コントローラー上の 1 つ以上のピンを介してデバイスにアクセスします。
CM_RESOURCE_CONNECTION_CLASS_SERIAL	シリアルバスまたはシリアルポートを介してデバイスにアクセスします。

u.Connection.Type

接続の種類。 Class = CM_RESOURCE_CONNECTION_CLASS_GPIOの場合、Type は次の値に設定されます。

値	意味
CM_RESOURCE_CONNECTION_TYPE_GPIO_IO	I/O 用に構成されている GPIO ピンを使用してデバイスにアクセスします。

割り込み要求入力として構成された GPIO ピンは、通常の割り込みリソース (CmResourceTypeInterrupt) としてアクセスされます。

Class = CM_RESOURCE_CONNECTION_CLASS_SERIALの場合、Type は次のいずれかの値に設定されます。

値	意味
CM_RESOURCE_CONNECTION_TYPE_SERIAL_I2C	デバイスは I2C バスに接続されています。
CM_RESOURCE_CONNECTION_TYPE_SERIAL_SPI	デバイスは SPI バスに接続されています。
CM_RESOURCE_CONNECTION_TYPE_SERIAL_UART	デバイスはシリアルポートに接続されています。