KSPIN_CONNECT Struktur (ks.h)
Clients verwenden die KSPIN_CONNECT-Struktur, um die Verbindung zu beschreiben, die sie von einem Treiber in einem KsCreatePin Aufruf anfordern.
Syntax
typedef struct {
KSPIN_INTERFACE Interface;
KSPIN_MEDIUM Medium;
ULONG PinId;
HANDLE PinToHandle;
KSPRIORITY Priority;
} KSPIN_CONNECT, *PKSPIN_CONNECT;
Angehörige
Interface
Gibt die für diese Verbindung zu verwendende KSPIN_INTERFACE an.
Medium
Eine Struktur vom Typ KSPIN_MEDIUM, die das medium angibt, das für diese Verbindung verwendet werden soll.
PinId
Gibt die PIN-Typ-ID-Nummer an. Wenn das Feld "PinToHandle" nicht NULL-ist, enthält dieses Feld den Bezeichner des Quellhefts, an den die Anforderung gesendet wird. Andernfalls bezieht sich dieses Feld auf den Spülnadel, mit dem eine Verbindung hergestellt wird. Wenn eine Pin sowohl eine Quelle als auch eine Spüle in der Kommunikation unterstützen kann, ist dies die implizite Methode, um sie zu sagen, wie sie in der Verbindung handeln soll.
PinToHandle
Gibt an, für welche Art von Zielheftung die Erstellung vorgesehen ist, und im Fall eines Quellziels, mit welcher Pin eine Verbindung hergestellt werden soll. Dieses Element ist NULL-, wenn ein Client eine Verbindung mit sich selbst anfordert. Andernfalls ist sie das Ziel der Verbindungsanforderung. Im Fall eines Quellziels enthält dies das Handle der Pininstanz, mit der eine Verbindung hergestellt werden soll. Im Falle eines Senkenziels enthält dieses Feld NULL-und wird andernfalls nicht verwendet.
Priority
Eine Struktur vom Typ KSPRIORITY, die die Priorität für die Verbindung angibt, in der Regel KSPRIORITY_NORMAL. Weitere Informationen finden Sie in der eigenschaft KSPROPERTY_CONNECTION_PRIORITY.
Bemerkungen
Wenn die KSPIN_CONNECT. PinToHandle-Element ist nicht NULL-, IRP_MJ_CREATE weist das Gerät an, die Quelle KSPIN_CONNECT zu verbinden. PinId-Pin an die KSPIN_CONNECT. PinToHandle-Pininstanz. Andernfalls ist dies eine Anforderung von einem Client für die Verbindung mit dem KSPIN_CONNECT. PinId-Pin mit dem KSPIN_CONNECT. Mittlere Methode und ein bestimmtes Datenformat, das nach der Verbindungsstruktur angegeben ist. In beiden Fällen schlägt der Gerätetreiber diese Anforderung möglicherweise fehl, wenn diese Verbindung nicht akzeptiert werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ks.h (enthalten Ks.h) |