Funzione KsCreatePin2 (ks.h)

Articolo
02/07/2025

Passa una richiesta di connessione a un dispositivo, creando un'istanza di pin.

Supportato a partire da Windows 8.

Sintassi

KSDDKAPI HRESULT KsCreatePin2(
  [in]  HANDLE         FilterHandle,
  [in]  PKSPIN_CONNECT Connect,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        ConnectionHandle
);

Parametri

[in] FilterHandle

Specifica l'handle del filtro che avvia la richiesta di creazione e la posizione in cui si verificherà la connessione.

[in] Connect

Puntatore a una struttura KSPIN_CONNECT che contiene parametri per la connessione richiesta. Questa operazione deve essere seguita in memoria da una struttura di dati KSDATAFORMAT, che descrive il formato dei dati richiesto per la connessione.

[in] DesiredAccess

Specifica l'accesso desiderato al pin. Si tratta in genere di GENERIC_READ o GENERIC_WRITE. Per il flusso di dati nel pin, questo valore deve essere impostato su GENERIC_WRITEe per il flusso di dati all'esterno del pin deve essere impostato su GENERIC_READ indipendentemente dal metodo di comunicazione.

[out] ConnectionHandle

Specifica l'handle di connessione passato. La routine riempie l'oggetto con un handle per l'oggetto file della connessione creata. Questo valore può quindi essere usato per disconnettersi con la funzione CloseHandle.

Valore restituito

Restituisce NOERROR in caso di esito positivo; in caso contrario, restituisce un codice di errore.

Osservazioni

Si tratta di una nuova versione della funzione KsCreatePin di e usa il broker di dispositivi per creare l'handle per l'oggetto di streaming del kernel. Inoltre, è necessario chiamare la funzione Com (Component Object Model) CoInitialize prima di chiamare questa funzione.

La routine invia una richiesta di IRP_MJ_CREATE al driver. Il driver accetta la richiesta solo se l'interfaccia, il supporto e il formato dati sono compatibili.

Se Connect-> PinToHandle è NULL, KsCreatePin2 crea un pin che il chiamante può usare per inviare richieste al driver di streaming specificato in Connect->FilterHandle. Connect:> PinId determina il tipo di pin da creare.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Universale
intestazione	ks.h (include Ks.h)
IRQL	PASSIVE_LEVEL

Vedere anche

KSDATAFORMAT

Condividi tramite