PCFILTER_DESCRIPTOR 구조체(portcls.h)

PCFILTER_DESCRIPTOR 구조는 미니포트 드라이버의 필터 구현을 설명합니다. 구조체는 필터의 핀, 노드, 연결 및 속성을 지정합니다.

구문

typedef struct {
  ULONG                         Version;
  const PCAUTOMATION_TABLE      *AutomationTable;
  ULONG                         PinSize;
  ULONG                         PinCount;
  const PCPIN_DESCRIPTOR        *Pins;
  ULONG                         NodeSize;
  ULONG                         NodeCount;
  const PCNODE_DESCRIPTOR       *Nodes;
  ULONG                         ConnectionCount;
  const PCCONNECTION_DESCRIPTOR *Connections;
  ULONG                         CategoryCount;
  const GUID                    *Categories;
} PCFILTER_DESCRIPTOR, *PPCFILTER_DESCRIPTOR;

구성원

Version

예약되어 있습니다. 0으로 초기화합니다.

AutomationTable

자동화 테이블에 대한 포인터입니다. PCAUTOMATION_TABLE 형식의 구조입니다. 자동화 테이블은 필터 인스턴스의 속성에 대한 처리기를 지정합니다.

PinSize

Pin 배열에 있는 각 요소의 크기(바이트)를 지정 합니다 . 이 값은 8의 배수여야 하며 적어도 sizeof(PCPIN_DESCRIPTOR)여야 합니다. 값이 크면 클라이언트별 설명자 정보를 핀 설명자에 추가할 수 있습니다.

PinCount

핀 배열의 핀 설명자 수를 지정 합니다 .

Pins

핀 설명자의 배열에 대한 포인터입니다. 각 배열 요소는 PCPIN_DESCRIPTOR 구조체입니다.

NodeSize

Nodes 배열에 있는 각 요소의 크기(바이트)를 지정합니다. 이 값은 8의 배수여야 하며 sizeof(PCNODE_DESCRIPTOR) 이상이어야 합니다. 값이 크면 클라이언트별 설명자 정보를 노드 설명자에 추가할 수 있습니다.

NodeCount

노드 배열의 노드 설명자 수를 지정 합니다 .

Nodes

노드 설명자의 배열에 대한 포인터입니다. 각 배열 요소는 PCNODE_DESCRIPTOR 구조체입니다.

ConnectionCount

Connections 배열의 연결 수를 지정합니다.

Connections

연결 설명자의 배열에 대한 포인터입니다. 각 배열 요소는 PCCONNECTION_DESCRIPTOR 구조체입니다.

CategoryCount

범주 배열의 GUID 수를 지정합니다.

Categories

개체가 속한 범주를 지정하는 GUID 배열에 대한 포인터입니다. 오디오 어댑터용 디바이스 인터페이스 설치에서 토폴로지 범주에 대한 설명을 참조하세요.

설명

포트 드라이버는 IMiniport::GetDescription 메서드를 호출하여 미니포트 드라이버의 필터 설명자를 가져옵니다. 필터 설명자는 미니포트 드라이버의 핀, 노드, 연결 및 속성을 설명하는 PCFILTER_DESCRIPTOR 구조체입니다. 자세한 내용은 필터, 고정 및 노드 속성을 참조하세요.

요구 사항

헤더	portcls.h(Portcls.h 포함)

참고 항목

IMiniport::GetDescription

PCAUTOMATION_TABLE

PCCONNECTION_DESCRIPTOR

PCNODE_DESCRIPTOR

PCPIN_DESCRIPTOR