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 Kontextelement der REENUMERATE_SELF_INTERFACE_STANDARD-Struktur übergeben wird.
Rückgabewert
Keine
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 in einer nachfolgenden IRP_MN_QUERY_DEVICE_RELATIONS BusRelations-Abfrage asynchron als fehlt. Dieser Bericht bewirkt, dass das aktuelle Gerät instance IRP_MN_SURPRISE_REMOVAL- und IRP_MN_REMOVE_DEVICE-Anforderungen empfängt. Nachdem die überraschende Entfernung verarbeitet wurde, wird eine neue instance des Geräts aufgezählt, und die AddDevice-Routine des Treibers wird aufgerufen, um den Gerätestapel neu zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista. |
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (include Wdm.h, Ntddk.h) |
| IRQL | PASSIVE_LEVEL |