PREENUMERATE_SELF Rückruffunktion (wdm.h)
Eine ReenumerateSelf Routine fordert an, dass ein Bustreiber ein untergeordnetes Gerät erneut aufzählt.
Syntax
PREENUMERATE_SELF PreenumerateSelf;
void PreenumerateSelf(
[in] PVOID Context
)
{...}
Parameter
[in] Context
Ein Zeiger auf schnittstellenspezifische Kontextinformationen. Der Aufrufer übergibt den Wert, der als Context Member der REENUMERATE_SELF_INTERFACE_STANDARD-Struktur übergeben wird.
Rückgabewert
Nichts
Bemerkungen
Die REENUMERATE_SELF_INTERFACE_STANDARD Schnittstellenstruktur stellt einen Zeiger auf die ReenumerateSelf Routine bereit.
Wenn der Bustreiber die Anforderung zum Zeitpunkt des Routineaufrufs verarbeiten kann, meldet der Bustreiber das Gerät asynchron als fehlt in einer nachfolgenden IRP_MN_QUERY_DEVICE_RELATIONS BusRelations-Abfrage. Dieser Bericht bewirkt, dass die aktuelle Geräteinstanz IRP_MN_SURPRISE_REMOVAL und IRP_MN_REMOVE_DEVICE Anforderungen empfängt. Nachdem die Überraschungsentfernung verarbeitet wurde, wird eine neue Instanz des Geräts aufgezählt, und die AddDevice Routine des Treibers wird aufgerufen, um den Gerätestapel neu zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h, Ntddk.h) |
| IRQL- | PASSIVE_LEVEL |