WdfIoResourceRequirementsListGetIoResList-Funktion (wdfresource.h)
[Gilt nur für KMDF]
Die WdfIoResourceRequirementsListGetIoResList Methode gibt ein Handle an das Framework-Ressourcenbereich-Listenobjekt zurück, das eine angegebene logische Konfiguration darstellt, in einer angegebenen Ressourcenanforderungensliste.
Syntax
WDFIORESLIST WdfIoResourceRequirementsListGetIoResList(
[in] WDFIORESREQLIST RequirementsList,
[in] ULONG Index
);
Parameter
[in] RequirementsList
Ein Handle für ein Framework-Ressourcenanforderungen-Listenobjekt, das die Ressourcenanforderungensliste eines Geräts darstellt.
[in] Index
Ein nullbasierter Wert, der als Index in der Liste der Ressourcenanforderungen verwendet wird, die RequirementsList- angibt.
Rückgabewert
WdfIoResourceRequirementsListGetIoResList gibt ein Handle an das Framework-Ressourcenbereichslistenobjekt zurück, das die logische Konfiguration darstellt, die der Index Parameter identifiziert, wenn der Indexwert gültig ist. Andernfalls gibt die Methode NULL-zurück.
Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Bemerkungen
Weitere Informationen zu Ressourcenanforderungenslisten finden Sie unter Hardwareressourcen für Framework-Based Drivers.
Im folgenden Codebeispiel wird die Ressourcenanforderungsliste eines Geräts durchsucht, um den ersten Ressourcendeskriptor zu finden, der eine Unterbrechungsressource beschreibt.
NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
IN WDFDEVICE Device,
IN WDFIORESREQLIST RequirementsList
)
{
ULONG i, j, reqCount, resCount;
BOOLEAN descriptorFound = FALSE;
//
// Obtain the number of logical configurations.
//
reqCount = WdfIoResourceRequirementsListGetCount(RequirementsList);
//
// Search each logical configuration.
//
for (i = 0; i < reqCount; i++) {
WDFIORESLIST reslist;
if (descriptorFound) {
break;
}
reslist = WdfIoResourceRequirementsListGetIoResList(
RequirementsList,
i
);
//
// Get the number of resource descriptors that
// are in this logical configuration.
//
resCount = WdfIoResourceListGetCount(reslist);
for (j = 0; j < resCount; j++) {
PIO_RESOURCE_DESCRIPTOR descriptor;
//
// Get the next resource descriptor.
//
descriptor = WdfIoResourceListGetDescriptor(
reslist,
j
);
//
// Stop if this descriptor is an interrupt descriptor.
//
if (descriptor->Type == CmResourceTypeInterrupt) {
descriptorFound = TRUE;
break;
}
}
}
...
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfresource.h (include Wdf.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |