Metodo IWDFUsbInterface::RetrieveUsbPipeObject (wudfusb.h)

Articolo
08/08/2023

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

Il metodo RetrieveUsbPipeObject recupera un oggetto pipe USB per l'indice pipe specificato.

Sintassi

HRESULT RetrieveUsbPipeObject(
  [in]  UCHAR             PipeIndex,
  [out] IWDFUsbTargetPipe **ppPipe
);

Parametri

[in] PipeIndex

Indice dell'oggetto pipe USB da recuperare.

[out] ppPipe

Puntatore a una variabile che riceve un puntatore all'interfaccia IWDFUsbTargetPipe per l'oggetto pipe USB il cui indice è specificato da PipeIndex.

Valore restituito

RetrieveUsbPipeObject restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	RetrieveUsbPipeObject ha recuperato correttamente l'oggetto pipe USB.
E_OUTOFMEMORY	RetrieveUsbPipeObject ha rilevato un errore di allocazione.
Codice di errore definito in Winerror.h	Questo valore corrisponde al codice di errore restituito dall'API WinUsb.

Commenti

Un driver UMDF può chiamare i metodi dell'interfaccia IWDFUsbTargetPipe recuperata dal metodo RetrieveUsbPipeObject per ottenere il tipo di pipe e altre informazioni.

Esempio

Per un esempio di codice su come usare il metodoRetrieveUsbPipeObject , vedere IWDFUsbInterface::GetNumEndPoints.

Requisiti

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione	Desktop
Versione UMDF minima	1.5
Intestazione	wudfusb.h (include Wudfusb.h)
DLL	WUDFx.dll

Vedi anche

IWDFUsbInterface

IWDFUsbTargetPipe

Condividi tramite