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

Weitere Informationen

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_REMOVE_DEVICE

IRP_MN_SURPRISE_REMOVAL

REENUMERATE_SELF_INTERFACE_STANDARD