IKsTopology::CreateNodeInstance-Methode (ksproxy.h)

Artikel
02/29/2024

Die CreateNodeInstance-Methode fordert ein KS-Filterobjekt an, um ein Topologieknotenobjekt zu öffnen.

Syntax

HRESULT CreateNodeInstance(
  [in]           ULONG       NodeId,
  [in]           ULONG       Flags,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] IUnknown    *UnkOuter,
  [in]           REFGUID     InterfaceId,
  [out]          LPVOID      *Interface
);

Parameter

[in] NodeId

Bezeichner für das zu öffnende Topologieknotenobjekt.

[in] Flags

Eine Bitmaske, die den Typ des Topologieknotenobjekts aufzählt. Derzeit sind keine Flags definiert.

[in] DesiredAccess

Eine ACCESS_MASK Bitmaske, die den Typ des Zugriffs angibt, den der Aufrufer für das Topologieknotenobjekt benötigt. Eine Beschreibung der einzelnen Zugriffsberechtigungswerte finden Sie unter ZwCreateFile .

[in, optional] UnkOuter

Zeiger auf eine IUnknown-Schnittstelle , die die Topologieknotenschnittstelle unterstützt.

[in] InterfaceId

Bezeichner der angeforderten Topologieknotenschnittstelle.

[out] Interface

Zeiger auf eine Variable, die den in InterfaceId angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *Interface den angeforderten Schnittstellenzeiger auf das Objekt. Wenn das Objekt die in InterfaceId angegebene Schnittstelle nicht unterstützt, wird *Interface auf NULL festgelegt.