Funzione WdfUsbTargetPipeWdmGetPipeHandle (wdfusb.h)
[Si applica solo a KMDF]
Il metodo WdfUsbTargetPipeWdmGetPipeHandle restituisce l'handle USBD_PIPE_HANDLE tipizzato associato a un oggetto pipe del framework specificato.
Sintassi
USBD_PIPE_HANDLE WdfUsbTargetPipeWdmGetPipeHandle(
[in] WDFUSBPIPE UsbPipe
);
Parametri
[in] UsbPipe
Handle a un oggetto pipe del framework ottenuto chiamando WdfUsbInterfaceGetConfiguredPipe.
Valore restituito
WdfUsbTargetPipeWdmGetPipeHandle restituisce un handle USBD_PIPE_HANDLE tipizzato.
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Un driver basato su framework deve ottenere un handle tipizzato di USBD_PIPE_HANDLE solo se crea un handle di pipe che richiede un handle pipe.
Il driver può chiamare il metodo WdfUsbTargetPipeWdmGetPipeHandle dopo aver chiamato WdfUsbTargetDeviceSelectConfig. L'handle USBD_PIPE_HANDLE tipizzato restituito da WdfUsbTargetPipeWdmGetPipeHandle è valido fino a quando il driver chiama di nuovo WdfUsbTargetDeviceSelectConfig , il driver chiama WdfUsbInterfaceSelectSetting o l'oggetto pipe del framework viene eliminato. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto pipe del framework e se l'oggetto viene eliminato prima che il driver chiami di nuovo WdfUsbTargetDeviceSelectConfig o chiama WdfUsbInterfaceSelectSetting, l'handle è valido finché non viene restituita la funzione EvtCleanupCallback dell'oggetto.
Per altre informazioni sul metodo WdfUsbTargetPipeWdmGetPipeHandle e sulle destinazioni DI I/O USB, vedere Destinazioni di I/O USB.
Esempio
Nell'esempio di codice seguente viene ottenuto l'handle USBD_PIPE_HANDLE tipizzato per una pipe specificata.
USBD_PIPE_HANDLE usbdPipeHandle;
usbdPipeHandle = WdfUsbTargetPipeWdmGetPipeHandle(UsbPipe);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfusb.h (include Wdfusb.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |