WdfFdoLockStaticChildListForIteration-Funktion (wdffdo.h)
[Gilt nur für KMDF]
Die WdfFdoLockStaticChildListForIteration-Methode bereitet das Framework für das Abrufen von Elementen aus der statischen untergeordneten Liste vor, die zu einem angegebenen übergeordneten Gerät gehört.
Syntax
void WdfFdoLockStaticChildListForIteration(
[in] WDFDEVICE Fdo
);
Parameter
[in] Fdo
Ein Handle für ein Frameworkgeräteobjekt, das das übergeordnete Gerät darstellt.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Bustreiber, die die statische Busaufzählung verwenden, können WdfFdoLockStaticChildListForIteration aufrufen.
Nach dem Aufruf von WdfFdoLockStaticChildListForIteration kann der Treiber WdfFdoRetrieveNextStaticChild wiederholt aufrufen, um Informationen zu jedem untergeordneten Gerät in der untergeordneten Liste abzurufen.
Nachdem der Treiber den Aufruf von WdfFdoRetrieveNextStaticChild abgeschlossen hat, muss er WdfFdoUnlockStaticChildListFromIteration aufrufen.
Wenn der Treiber nach dem Aufruf von WdfFdoLockStaticChildListForIteration Änderungen an der untergeordneten Liste vornimmt, speichert das Framework alle Änderungen und benachrichtigt den PnP-Manager (Plug & Play) über die Änderungen, wenn der Treiber WdfFdoUnlockStaticChildListFromIteration aufruft.
Der Treiber kann Aufrufe von WdfFdoLockStaticChildListForIteration und WdfFdoUnlockStaticChildListFromIteration schachteln. Wenn der Treiber diese Methoden verschachtelt, speichert das Framework alle Änderungen bis zum letzten Aufruf von WdfFdoUnlockStaticChildListFromIteration.
Weitere Informationen zu statischen untergeordneten Listen finden Sie unter Statische Enumeration.
Beispiele
Ein Codebeispiel, das WdfFdoLockStaticChildListForIteration verwendet, finden Sie unter WdfFdoRetrieveNextStaticChild.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdffdo.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |