KSPIN_CONNECT 구조체(ks.h)
클라이언트는 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 입니다. 그렇지 않으면 연결 요청의 대상입니다. 원본 대상의 경우 연결을 설정할 핀 instance 핸들이 포함됩니다. 싱크 대상의 경우 이 필드는 NULL을 포함하며, 그렇지 않으면 사용되지 않습니다.
Priority
연결의 우선 순위를 지정하는 KSPRIORITY 형식의 구조체로, 일반적으로 KSPRIORITY_NORMAL. 자세한 내용은 KSPROPERTY_CONNECTION_PRIORITY 속성을 참조하세요.
설명
If the KSPIN_CONNECT. PinToHandle 요소는 NULL이 IRP_MJ_CREATE 디바이스에 원본 KSPIN_CONNECT 연결하도록 지시합니다. pinId를 KSPIN_CONNECT 고정합니다. PinToHandle 핀 instance. 그렇지 않으면 KSPIN_CONNECT 대한 연결에 대한 클라이언트의 요청입니다. KSPIN_CONNECT 사용하여 PinId 핀을 지정합니다. 중간 메서드 및 연결 구조 다음에 지정된 특정 데이터 형식입니다. 두 경우 모두 이 연결을 수락할 수 없는 경우 디바이스 드라이버가 이 요청에 실패할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | ks.h(Ks.h 포함) |