struttura KSPIN_CONNECT (ks.h)
I client usano la struttura KSPIN_CONNECT per descrivere la connessione richiesta da un driver in una chiamata KsCreatePin.
Sintassi
typedef struct {
KSPIN_INTERFACE Interface;
KSPIN_MEDIUM Medium;
ULONG PinId;
HANDLE PinToHandle;
KSPRIORITY Priority;
} KSPIN_CONNECT, *PKSPIN_CONNECT;
Membri
Interface
Specifica il KSPIN_INTERFACE da utilizzare per questa connessione.
Medium
Struttura di tipo KSPIN_MEDIUM che specifica il supporto da utilizzare per questa connessione.
PinId
Specifica il numero ID del tipo di pin. Se il campo PinToHandle non è NULL, questo campo contiene l'identificatore del pin di origine a cui viene inviata la richiesta. In caso contrario, questo campo fa riferimento al pin sink a cui si sta connettendo. Se un pin può supportare sia l'origine che il sink nelle comunicazioni, questo è il metodo implicito per indicare come deve agire nella connessione.
PinToHandle
Specifica il tipo di pin di destinazione a cui è destinata la creazione e, nel caso di una destinazione di origine, il pin a cui connettersi. Questo membro è NULL quando un client richiede una connessione a se stesso. In caso contrario, è la destinazione della richiesta di connessione. Nel caso di una destinazione di origine, questo contiene l'handle dell'istanza del pin a cui stabilire una connessione. Nel caso di una destinazione sink, questo campo contiene NULLe non viene usato in altro modo.
Priority
Struttura di tipo KSPRIORITY che specifica la priorità per la connessione, in genere KSPRIORITY_NORMAL. Per informazioni dettagliate, vedere la proprietà KSPROPERTY_CONNECTION_PRIORITY.
Osservazioni
Se il KSPIN_CONNECT. L'elemento PinToHandle non è NULL, IRP_MJ_CREATE indica al dispositivo di connettere il KSPIN_CONNECT di origine. PinId viene aggiunto al KSPIN_CONNECT. Istanza pin PinToHandle. In caso contrario, si tratta di una richiesta da un client per la connessione al KSPIN_CONNECT. PinId tramite il KSPIN_CONNECT. Metodo medio e un formato di dati specifico specificato dopo la struttura di connessione. In entrambi i casi, il driver di dispositivo potrebbe non riuscire questa richiesta se questa connessione non può essere accettata.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ks.h (include Ks.h) |