KsInstallBusEnumInterface-Funktion (swenum.h)

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

Die KsInstallBusEnumInterface Funktion installiert eine Schnittstelle zum Anforderungsladebus-Enumeratorobjekt.

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 Objektschnittstelle für den Anforderungsladebus angibt. Informationen zu dieser Struktur finden Sie im Abschnitt "Hinweise" weiter unten.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

Die Irp->AssociatedIrp.SystemBuffer wird angenommen, dass sie eine SWENUM_INSTALL_INTERFACE Struktur enthält. Die DeviceId, InterfaceId und ReferenceString Member der Struktur geben das bestimmte Gerät und die Schnittstelle an, mit dem auf diese neue Schnittstelle zugegriffen werden soll. Wenn die Schnittstelle mit Plug and Play für die Schnittstellen-GUID registriert ist und auf die zugehörige Verweiszeichenfolge zum ersten Mal über IRP_MJ_CREATE zugegriffen wird, wird das Gerät mithilfe des Formats bus-identifier-prefix\device-id-GUID-stringaufgezählt. Beispiel: SW{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xx}.

Anforderungen

Siehe auch

KsRemoveBusEnumInterface

SWENUM_INSTALL_INTERFACE