Condividi tramite


Funzione KsCreateTopologyNode2 (ks.h)

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 se l'operazione riesce; in caso contrario, restituisce un codice di errore.

Commenti

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, la funzione CoInitialize com (Component Object Model) deve essere chiamata prima di chiamare questa funzione.

Requisiti

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

Vedi anche

ACCESS_MASK

Coinitialize

KSNODE_CREATE

KsCreateTopologyNode