KSMETHOD 구조체

아티클
02/12/2024

KSMETHOD 구조체는 메서드 집합 내에서 단일 커널 스트리밍 메서드를 지정합니다.

KSEVENT, KSMETHOD 및 KSPROPERTY 구조체는 KSIDENTIFIER 구조체의 별칭입니다. 따라서 해당 정의는 동일합니다.

구문

struct KSMETHOD {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

멤버

Set

커널 스트리밍 메서드 집합을 식별하는 GUID를 지정합니다.

메서드 집합 GUID에 대한 자세한 내용은 아래 설명 섹션을 참조하세요.

Id

메서드 집합의 멤버를 지정합니다.

Flags

요청 유형을 지정합니다. 또한 KSMETHOD_ITEM )에 대한 KSMETHOD_TYPE_Xxx 플래그를 참조하세요.

요청에는 다음 표에 나열된 값의 조합이 포함될 수 있습니다.

값	메서드 요청 유형
KSMETHOD_TYPE_BASICSUPPORT	미니드라이버를 쿼리하여 메서드 집합의 지정된 메서드를 지원하는지 여부를 확인하도록 나타냅니다.
KSMETHOD_TYPE_SEND	미니드라이버가 지정된 메서드를 실행해야 했음을 나타냅니다. 지정된 매개 변수에 대한 메서드의 효과는 클라이언트에 알려야 합니다. 즉, 매개 변수를 읽거나 쓸지, 둘 다에서 읽는지, 둘 다 읽는지 또는 둘 다에 기록하지 않는지를 클라이언트에 알려야 합니다. 미니 드라이버는 KSMETHOD_ITEM 구조를 사용하여 매개 변수에 대한 메서드의 효과를 지정합니다.
KSMETHOD_TYPE_SETSUPPORT	미니드라이버를 쿼리하여 지정된 메서드 집합을 지원하는지 여부를 나타냅니다.
KSMETHOD_TYPE_TOPOLOGY	지정한 메서드가 KSM_NODE 형식임을 나타냅니다. 여기서 NodeId 멤버는 토폴로지 노드의 식별자입니다. 이 플래그를 자체적으로 설정하지 마세요. 대신 이 목록의 다른 플래그와 함께 또는 입니다.

설명

Microsoft는 여러 시스템 정의 메서드 집합 GUID를 제공합니다. 미니 드라이버는 Set 멤버에서 이러한 GUID 중 하나를 지정합니다. 커널 스트리밍 메서드 집합은 일반적으로 KSMETHODSETID 접두사로 시작합니다. 커널 스트리밍 메서드 집합은 ks.h, ksmedia.h, bdamedia.h 및 기타 헤더 파일로 정의됩니다.

커널 스트리밍 이벤트에 대한 자세한 내용은 KS 속성, 이벤트 및 메서드를 참조하세요.

클라이언트는 KSMETHOD 구조와 함께 IOCTL_KS_METHOD 요청을 사용하여 미니 드라이버가 처리하는 커널 스트리밍 개체에서 메서드를 실행할 수 있습니다. 자세한 내용은 KS 메서드를 참조하세요.