IKsTopology::CreateNodeInstance 메서드(ksproxy.h)

아티클
02/29/2024

CreateNodeInstance 메서드는 KS 필터 개체를 요청하여 토폴로지 노드 개체를 엽니다.

구문

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

매개 변수

[in] NodeId

열 토폴로지 노드 개체의 식별자입니다.

[in] Flags

토폴로지 노드 개체의 형식을 열거하는 비트 마스크입니다. 플래그는 현재 정의되어 있지 않습니다.

[in] DesiredAccess

호출자가 토폴로지 노드 개체에 필요한 액세스 유형을 지정하는 ACCESS_MASK 비트 마스크입니다. 각 액세스 오른쪽 값에 대한 설명은 ZwCreateFile 을 참조하세요.

[in, optional] UnkOuter

토폴로지 노드 인터페이스를 지원하는 IUnknown 인터페이스에 대한 포인터입니다.

[in] InterfaceId

요청되는 토폴로지 노드 인터페이스의 식별자입니다.

[out] Interface

InterfaceId에서 요청된 인터페이스 포인터를 수신하는 변수에 대한 포인터입니다. 반환이 성공하면 *Interface 에는 개체에 대한 요청된 인터페이스 포인터가 포함됩니다. 개체가 InterfaceId에 지정된 인터페이스를 지원하지 않으면 *Interface 가 NULL로 설정됩니다.