Функция WdfCmResourceListGetCount (wdfresource.h)

[Относится к KMDF и UMDF]

Метод WdfCmResourceListGetCount возвращает количество дескрипторов ресурсов, содержащихся в указанном списке ресурсов.

Синтаксис

ULONG WdfCmResourceListGetCount(
  [in] WDFCMRESLIST List
);

Параметры

[in] List

Дескриптор объекта списка ресурсов платформы, который представляет список аппаратных ресурсов для устройства.

Возвращаемое значение

WdfCmResourceListGetCount возвращает количество дескрипторов ресурсов, содержащихся в списке ресурсов, указанном параметром List .

Системная ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

Дополнительные сведения о списках ресурсов см. в разделе Аппаратные ресурсы для драйверов Framework-Based.

Примеры

В следующем примере кода показано, как функция обратного вызова EvtDevicePrepareHardware может найти ресурсы памяти, порта и прерывания в списке переведенных аппаратных ресурсов, назначенных диспетчером Plug and Play (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;
        }
    }
}

Требования