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;
Member
Interface
Gibt die KSPIN_INTERFACE an, die für diese Verbindung verwendet werden soll.
Medium
Eine Struktur vom Typ KSPIN_MEDIUM , die das Medium angibt, das für diese Verbindung verwendet werden soll.
PinId
Gibt die Pintyp-ID-Nummer an. Wenn das PinToHandle-Feld nicht NULL ist, enthält dieses Feld den Bezeichner des Quell-Pins, an den die Anforderung gesendet wird. Andernfalls bezieht sich dieses Feld auf den Senkennadel, mit dem verbunden wird. Wenn ein Pin unterstützen kann, sowohl eine Quelle als auch eine Senke in der Kommunikation zu sein, dann ist dies die implizite Methode, um ihm mitzuteilen, wie er in der Verbindung handeln soll.
PinToHandle
Gibt an, für welche Art von Zielnadel die Erstellung vorgesehen ist, und im Fall eines Quellziels, mit welcher Pin eine Verbindung hergestellt werden soll. Dieser Member ist NULL , wenn ein Client eine Verbindung mit sich selbst anfordert. Andernfalls ist es das Ziel der Verbindungsanforderung. Im Fall eines Quellziels enthält diese das Handle der Pin, die instance, mit der eine Verbindung hergestellt werden soll. Im Fall eines Senkenziels enthält dieses Feld NULL und wird nicht anderweitig verwendet.
Priority
Eine Struktur vom Typ KSPRIORITY , die die Priorität für die Verbindung angibt, normalerweise KSPRIORITY_NORMAL. Weitere Informationen finden Sie in der eigenschaft KSPROPERTY_CONNECTION_PRIORITY .
Hinweise
Wenn der KSPIN_CONNECT. PinToHandle-Element ist nicht NULL, IRP_MJ_CREATE weist das Gerät an, die Quell-KSPIN_CONNECT zu verbinden. PinId an die KSPIN_CONNECT. PinToHandle instance. Andernfalls handelt es sich um eine Anforderung eines Clients 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 wird. 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 (ks.h einschließen) |