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 |