WdfCmResourceListGetCount 関数 (wdfresource.h)

[KMDF と UMDF に適用]

WdfCmResourceListGetCount メソッドは、指定されたリソース リストに含まれるリソース記述子の数を返します。

構文

ULONG WdfCmResourceListGetCount(
  [in] WDFCMRESLIST List
);

パラメーター

[in] List

デバイスのハードウェア リソースの一覧を表すフレームワーク リソースリスト オブジェクトへのハンドル。

戻り値

WdfCmResourceListGetCount は、 List パラメーターが指定するリソース リストに含まれるリソース記述子の数を返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。

注釈

リソース 一覧の詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。

例

次のコード例は、EvtDevicePrepareHardware コールバック関数が、プラグ アンド プレイ (PnP) マネージャーがデバイスに割り当てた変換されたハードウェア リソースの一覧でメモリ、ポート、割り込みリソースを検索する方法を示しています。

NTSTATUS
MyEvtDevicePrepareHardware (
    WDFDEVICE  Device,
    WDFCMRESLIST  Resources,
    WDFCMRESLIST  ResourcesTranslated
    )
{
    ULONG  i;
    PCM_PARTIAL_RESOURCE_DESCRIPTOR  desc;

    for (i = 0; i < WdfCmResourceListGetCount(ResourcesTranslated); i++) {

        desc = WdfCmResourceListGetDescriptor(
                                              ResourcesTranslated,
                                              i
                                              );

        switch (desc->Type) {

            case CmResourceTypeMemory:
                //
                // Handle memory resources here.
                //
                break;

            case CmResourceTypePort:
                //
                // Handle port resources here.
                //
                break;

            case CmResourceTypeInterrupt:
                //
                // Handle interrupt resources here.
                //
                break;
            default:
                //
                // Ignore all other descriptors.
                //
                break;
        }
    }
}

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfresource.h (Wdf.h を含む)
Library	Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)