KsInstallBusEnumInterface-Funktion (swenum.h)

Diese Funktion ist nur für die interne Verwendung vorgesehen.

Die KsInstallBusEnumInterface-Funktion installiert eine Schnittstelle zum Enumeratorobjekt des Anforderungslastbus.

Syntax

KSDDKAPI NTSTATUS KsInstallBusEnumInterface(
  [in] PIRP Irp
);

Parameter

[in] Irp

Zeiger auf ein IRP, das eine SWENUM_INSTALL_INTERFACE-Struktur enthält, die die zu installierende Enumerator-Objektschnittstelle des Anforderungslastbus angibt. Informationen zu dieser Struktur finden Sie weiter unten im Abschnitt Hinweise.

Rückgabewert

Gibt bei erfolgreicher Ausführung STATUS_SUCCESS zurück. Andernfalls wird ein Fehlercode zurückgegeben.

Hinweise

Es wird davon ausgegangen, dass der Irp-AssociatedIrp.SystemBuffer> eine SWENUM_INSTALL_INTERFACE-Struktur enthält. Die Member DeviceId, InterfaceId und ReferenceString der Struktur geben das spezifische Gerät und die Schnittstelle an, mit der auf diese neue Schnittstelle zugegriffen werden soll. Wenn die Schnittstelle bei Plug & Play für die Schnittstellen-GUID registriert ist und beim ersten Mal über IRP_MJ_CREATE auf die zugehörige Verweiszeichenfolge zugegriffen wird, wird das Gerät im Format bus-identifier-prefix\device-id-GUID-string aufgezählt. Beispiel: SW{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

Anforderungen

Weitere Informationen

KsRemoveBusEnumInterface

SWENUM_INSTALL_INTERFACE