PcRegisterSubdevice-Funktion (portcls.h)

Die PcRegisterSubdevice-Funktion registriert ein Untergerät, um es für die Verwendung durch Clients verfügbar zu machen.

Syntax

PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PWSTR          Name,
  [in] PUNKNOWN       Unknown
);

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt des Adaptertreibers. Dies ist eine Systemstruktur vom Typ DEVICE_OBJECT.

[in] Name

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Untergeräts angibt. Der Zeichenfolgenpuffer, auf den der Name-Parameter verweist, muss für die Lebensdauer des Geräteobjekts gültig bleiben. Die Zeichenfolge enthält einen Kurznamen, der das Untergerät von allen anderen Auf demselben Gerät registrierten Untergeräten unterscheidet. Jedes der Untergeräte des Geräts muss einen eindeutigen Namen haben.

[in] Unknown

Zeiger auf die IPort-Schnittstelle des Porttreiberobjekts, das an das Untergerät gebunden ist.

Rückgabewert

PcRegisterSubdevice gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben.

Hinweise

Die Funktion registriert die Geräteschnittstelle instance für ein Filterobjekt, das ein Untergerät auf einem Audioadapter darstellt. Der E/A-Manager fügt die durch den Name-Parameter angegebene Zeichenfolge an die Verweiszeichenfolge an, die er zum Identifizieren der instance verwendet. Die geänderte Verweiszeichenfolge ist nützlich, um zwischen den Untergeräte im Audioadapter zu unterscheiden. Weitere Informationen zu Verweiszeichenfolgen finden Sie unter IoRegisterDeviceInterface.

Weitere Informationen zur Rolle der PcRegisterSubdevice-Funktion beim Registrieren eines Untergerätes finden Sie unter Untergeräteerstellung.

Ein Adaptertreiber kann die IUnregisterSubdevice::UnregisterSubdevice-Methode aufrufen, um die Registrierung einer physischen Verbindung zu löschen, die durch einen vorherigen Aufruf von PcRegisterSubdevice registriert wurde. Weitere Informationen finden Sie unter Dynamische Audiountergeräte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Der PortCls-Systemtreiber implementiert die PcRegisterSubdevice-Funktion in Microsoft Windows 98/Me und windows 2000 und höher.
Zielplattform	Universell
Header	portcls.h (portcls.h einschließen)
Bibliothek	Portcls.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

DEVICE_OBJECT

Iport

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface