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) |