피드백

KSPIN_CONNECT 구조체(ks.h)

  • 아티클
  • 읽는 데 2분 걸림

클라이언트는 KSPIN_CONNECT 구조를 사용하여 KsCreatePin 호출에서 드라이버에서 요청하는 연결을 설명합니다.

구문

typedef struct {
  KSPIN_INTERFACE Interface;
  KSPIN_MEDIUM    Medium;
  ULONG           PinId;
  HANDLE          PinToHandle;
  KSPRIORITY      Priority;
} KSPIN_CONNECT, *PKSPIN_CONNECT;

멤버

Interface

이 연결에 사용할 KSPIN_INTERFACE 지정합니다.

Medium

이 연결에 사용할 매체를 지정하는 형식 KSPIN_MEDIUM 구조입니다.

PinId

핀 유형 ID 번호를 지정합니다. PinToHandle 필드가 NULL이 아닌 경우 이 필드에는 요청이 전송되는 원본 핀의 식별자가 포함됩니다. 그렇지 않으면 이 필드는 연결되어 있는 싱크 핀을 참조합니다. 핀이 통신에서 원본 및 싱크를 모두 지원할 수 있는 경우 연결에서 작동해야 하는 방법을 알려주는 암시적 방법입니다.

PinToHandle

만들려는 대상 핀 유형과 원본 대상의 경우 연결할 핀을 지정합니다. 클라이언트가 자체에 대한 연결을 요청할 때 이 멤버는 NULL 입니다. 그렇지 않으면 연결 요청의 대상입니다. 원본 대상의 경우 연결을 설정하는 핀 인스턴스의 핸들이 포함됩니다. 싱크 대상의 경우 이 필드에 는 NULL이 포함되며, 그렇지 않으면 사용되지 않습니다.

Priority

연결의 우선 순위를 지정하는 KSPRIORITY 형식의 구조체로, 일반적으로 KSPRIORITY_NORMAL. 자세한 내용은 KSPROPERTY_CONNECTION_PRIORITY 속성을 참조하세요.

설명

If the KSPIN_CONNECT. PinToHandle 요소는 NULL이 아닙니다. IRP_MJ_CREATE 디바이스에 원본 KSPIN_CONNECT 연결하도록 지시합니다. KSPIN_CONNECT PinId 핀입니다. PinToHandle 핀 인스턴스. 그렇지 않으면 KSPIN_CONNECT 연결하기 위한 클라이언트의 요청입니다. KSPIN_CONNECT 사용하는 PinId 핀입니다. 중간 메서드 및 연결 구조 다음에 지정된 특정 데이터 형식입니다. 두 경우 모두 이 연결을 수락할 수 없는 경우 디바이스 드라이버가 이 요청에 실패할 수 있습니다.

요구 사항

   
헤더 ks.h(Ks.h 포함)

참조

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin