KsCreateTopologyNode2-Funktion (ks.h)
Erstellt ein Handle für einen Topologieknoten instance.
Wird ab Windows 8 unterstützt.
Syntax
KSDDKAPI HRESULT KsCreateTopologyNode2(
[in] HANDLE ParentHandle,
[in] PKSNODE_CREATE NodeCreate,
[in] ACCESS_MASK DesiredAccess,
[out] PHANDLE NodeHandle
);
Parameter
[in] ParentHandle
Gibt das Handle für das übergeordnete Element an, auf dem der Knoten erstellt wird.
[in] NodeCreate
Eine KSNODE_CREATE-Struktur , die den Informationssatz beschreibt, der zum Erstellen des Topologieknotenhandles verwendet wird.
[in] DesiredAccess
Gibt einen ACCESS_MASK an, der den gewünschten Zugriff auf das Objekt angibt. Dies ist in der Regel GENERIC_READ und/oder GENERIC_WRITE.
[out] NodeHandle
Speicherort für das Topologieknotenhandle.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.
Hinweise
Dies ist eine neue Version der KsCreateTopologyNode-Funktion und verwendet den Gerätebroker, um das Handle für das Kernelstreamingobjekt zu erstellen. Darüber hinaus muss die ComInitialize-Funktion (Component Object Model) aufgerufen werden, bevor diese Funktion aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| IRQL | PASSIVE_LEVEL |