Funzione KsCreateTopologyNode2 (ks.h)

Articolo
02/07/2025

Crea un handle per un'istanza del nodo della topologia.

Supportato a partire da Windows 8.

Sintassi

KSDDKAPI HRESULT KsCreateTopologyNode2(
  [in]  HANDLE         ParentHandle,
  [in]  PKSNODE_CREATE NodeCreate,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        NodeHandle
);

Parametri

[in] ParentHandle

Specifica l'handle per l'elemento padre in cui viene creato il nodo.

[in] NodeCreate

Struttura KSNODE_CREATE che descrive il set di informazioni utilizzate per creare l'handle del nodo della topologia.

[in] DesiredAccess

Specifica un ACCESS_MASK che indica l'accesso desiderato all'oggetto. Si tratta in genere di GENERIC_READ e/o GENERIC_WRITE.

[out] NodeHandle

Percorso dell'handle del nodo della topologia.

Valore restituito

Restituisce NOERROR in caso di esito positivo; in caso contrario, restituisce un codice di errore.

Osservazioni

Si tratta di una nuova versione della funzione KsCreateTopologyNode e usa il broker di dispositivi per creare l'handle per l'oggetto di streaming del kernel. Inoltre, è necessario chiamare la funzione Com (Component Object Model) CoInitialize prima di chiamare questa funzione.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Universale
intestazione	ks.h (include Ks.h)
IRQL	PASSIVE_LEVEL

Vedere anche

Condividi tramite