Metodo IWDFUsbInterface::RetrieveUsbPipeObject (wudfusb.h)

Articolo
02/07/2025

[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 informazioni, vedi Introduzione a UMDF.]

Il metodo RetrieveUsbPipeObject recupera un oggetto pipe USB per l'indice di 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 recuperato correttamente l'oggetto pipe USB.
E_OUTOFMEMORY	RetrieveUsbPipeObject rilevato un errore di allocazione.
Codice di errore definito in Winerror.h	Questo valore corrisponde al codice di errore restituito dall'API WinUsb.

Osservazioni

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

Esempi

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

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.5
intestazione	wudfusb.h (include Wudfusb.h)
dll	WUDFx.dll

Vedere anche

IWDFUsbInterface

IWDFUsbTargetPipe

Condividi tramite