Struttura KSMETHOD

Articolo
06/15/2023

La struttura KSMETHOD specifica un singolo metodo di streaming del kernel all'interno di un set di metodi.

Le strutture KSEVENT, KSMETHOD e KSPROPERTY sono alias per la struttura KSIDENTIFIER . Di conseguenza, le loro definizioni sono identiche.

Sintassi

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

Members

Set

Specifica un GUID che identifica un set di metodi di streaming del kernel.

Per altre informazioni sui GUID del set di metodi, vedere la sezione Osservazioni di seguito.

Id

Specifica il membro del set di metodi.

Flags

Specifica il tipo di richiesta. Vedere anche i flag di KSMETHOD_TYPE_Xxx per KSMETHOD_ITEM).

Una richiesta può contenere una combinazione dei valori elencati nella tabella seguente.

Valore	Tipo di richiesta di metodo
KSMETHOD_TYPE_BASICSUPPORT	Indica di eseguire una query sul minidriver per determinare se supporta il metodo specificato del set di metodi.
KSMETHOD_TYPE_SEND	Indica che il minidriver deve eseguire il metodo specificato. L'effetto del metodo sui parametri specificati deve essere noto al client, ovvero se i parametri vengono letti da, scritti in, entrambi o nessuno dei due. Il minidriver usa la struttura KSMETHOD_ITEM per specificare l'effetto del metodo sui parametri.
KSMETHOD_TYPE_SETSUPPORT	Indica di eseguire una query sul minidriver per determinare se supporta il set di metodi specificato.
KSMETHOD_TYPE_TOPOLOGY	Indica che il metodo specificato è di tipo KSM_NODE, dove il membro NodeId è l'identificatore del nodo della topologia. Non impostare questo flag da solo; invece, OR con altri flag da questo elenco.

Commenti

Microsoft offre diversi GUID del set di metodi definiti dal sistema. I minidriver specificano uno di questi GUID nel membro Set . I set di metodi di streaming del kernel iniziano in genere con un prefisso KSMETHODSETID . I set di metodi di streaming del kernel sono definiti in ks.h, ksmedia.h, bdamedia.h e possibilmente altri file di intestazione.

Per altre informazioni sugli eventi di streaming del kernel, vedere Proprietà, eventi e metodi KS.

Un client può usare la richiesta di IOCTL_KS_METHOD insieme alla struttura KSMETHOD per eseguire metodi in un oggetto di streaming del kernel gestito dal minidriver. Per altre informazioni, vedere Metodi KS.