funzione WinUsb_GetPipePolicy (winusb.h)

Articolo
08/27/2023

La funzione WinUsb_GetPipePolicy recupera i criteri per una pipe specifica associata a un endpoint nel dispositivo. Si tratta di un'operazione sincrona.

Sintassi

BOOL WinUsb_GetPipePolicy(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      UCHAR                   PipeID,
  [in]      ULONG                   PolicyType,
  [in, out] PULONG                  ValueLength,
  [out]     PVOID                   Value
);

Parametri

[in] InterfaceHandle

Handle opaco per un'interfaccia che contiene l'endpoint a cui è associata la pipe.

Per eseguire una query sulla pipe associata all'endpoint nella prima interfaccia, usare l'handle restituito da WinUsb_Initialize. Per tutte le altre interfacce, usare l'handle per l'interfaccia di destinazione, recuperata da WinUsb_GetAssociatedInterface.

[in] PipeID

Valore a 8 bit costituito da un indirizzo a 7 bit e da un bit di direzione. Questo parametro corrisponde al campo bEndpointAddress nel descrittore dell'endpoint.

[in] PolicyType

Variabile ULONG che specifica il parametro dei criteri da recuperare. Il valore corrente per il parametro policy viene recuperato il parametro Value . Per informazioni sul comportamento dei criteri di pipe, vedere Funzioni WinUSB per la modifica dei criteri di pipe.

[in, out] ValueLength

Puntatore alla dimensione, in byte, del buffer a cui punta Value . Nell'output , ValueLength riceve le dimensioni, in byte, dei dati copiati nel buffer Value .

[out] Value

Puntatore a un buffer che riceve il valore dei criteri di pipe specificato.

Valore restituito

WinUsb_GetPipePolicy restituisce TRUE se l'operazione ha esito positivo. In caso contrario, questa routine restituisce FALSE e il chiamante può recuperare l'errore registrato chiamando GetLastError.

GetLastError può restituire il codice di errore seguente.