KSTOPOLOGY 구조체(ks.h)

KSTOPOLOGY 구조는 핀 및 노드의 토폴로지를 설명합니다.

구문

typedef struct {
  ULONG                       CategoriesCount;
  const GUID                  *Categories;
  ULONG                       TopologyNodesCount;
  const GUID                  *TopologyNodes;
  ULONG                       TopologyConnectionsCount;
  const KSTOPOLOGY_CONNECTION *TopologyConnections;
  const GUID                  *TopologyNodesNames;
  ULONG                       Reserved;
} KSTOPOLOGY, *PKSTOPOLOGY;

멤버

CategoriesCount

드라이버에서 지원하는 기능 범주의 수를 지정합니다.

Categories

드라이버에서 지원하는 기능 범주 배열의 시작을 가리킵니다.

TopologyNodesCount

드라이버에서 지원하는 노드 수를 지정합니다.

TopologyNodes

각 노드의 형식을 설명하는 GUID 배열의 시작을 가리킵니다. 비디오 커널 스트리밍 관련 노드 목록은 커널 스트리밍 토폴로지 노드를 참조하세요. 오디오 커널 스트리밍 관련 노드 목록은 오디오 토폴로지 노드를 참조하세요.

TopologyConnectionsCount

TopologyConnections가 가리키는 배열의 항목 수를 지정합니다. 각 항목의 노드 번호는 TopologyNodes 내 노드의 배열 오프셋에 해당해야 합니다. 이 구조가 스트리밍 미니드라이버의 HW_STREAM_HEADER 일부인 경우 핀 번호는 미니드라이버의 HW_STREAM_DESCRIPTOR 구조체에 있는 HW_STREAM_INFORMATION 구조체 배열 내의 오프셋에 해당해야 합니다.

TopologyConnections

이 구조체에 대한 토폴로지 연결 배열의 시작을 가리킵니다.

TopologyNodesNames

레지스트리에 저장된 노드에 대한 지역화된 유니코드 문자열 이름의 GUID를 지정합니다.

Reserved

시스템에서 사용하도록 예약되었습니다. 드라이버는 이를 0으로 설정해야 합니다.

설명

스트림 클래스 미니드라이버가 HW_STREAM_HEADER 구조의 일부로 이 구조를 만들고 전달합니다. 클래스 드라이버는 이 구조를 사용하여 토폴로지 속성 요청을 처리합니다. 클래스 드라이버가 반환하는 속성 데이터는 다음과 같이 KSTOPOLOGY 구조에서 결정됩니다.

요구 사항

추가 정보

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

HW_STREAM_INFORMATION

KSTOPOLOGY_CONNECTION