Funzione KsCreatePin2 (ks.h)

Passa una richiesta di connessione a un dispositivo, creando un'istanza del 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 verrà eseguita 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 di 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_WRITE e per il flusso di dati dal pin deve essere impostato su GENERIC_READ indipendentemente dal metodo di comunicazione.

[out] ConnectionHandle

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

Valore restituito

Restituisce NOERROR se l'operazione riesce; in caso contrario, restituisce un codice di errore.

Commenti

Si tratta di una nuova versione della funzione KsCreatePin e usa il broker di dispositivi per creare l'handle per l'oggetto di streaming del kernel. Inoltre, la funzione CoInitialize com (Component Object Model) deve essere chiamata 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.

Requisiti

Vedi anche

Coinitialize

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT

KsCreatePin