función WinUsb_GetPipePolicy (winusb.h)

Artículo
08/27/2023

La función WinUsb_GetPipePolicy recupera la directiva de una canalización específica asociada a un punto de conexión en el dispositivo. Se trata de una operación sincrónica.

Sintaxis

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

Parámetros

[in] InterfaceHandle

Identificador opaco de una interfaz que contiene el punto de conexión con el que está asociada la canalización.

Para consultar la canalización asociada al punto de conexión en la primera interfaz, use el identificador devuelto por WinUsb_Initialize. Para todas las demás interfaces, use el identificador de la interfaz de destino, recuperado por WinUsb_GetAssociatedInterface.

[in] PipeID

Valor de 8 bits que consta de una dirección de 7 bits y un bit de dirección. Este parámetro corresponde al campo bEndpointAddress en el descriptor del punto de conexión.

[in] PolicyType

Variable ULONG que especifica el parámetro de directiva que se va a recuperar. El valor actual del parámetro de directiva se recupera el parámetro Value . Para obtener información sobre el comportamiento de las directivas de canalización, vea Funciones winUSB para la modificación de la directiva de canalización.

[in, out] ValueLength

Puntero al tamaño, en bytes, del búfer al que apunta Value . En la salida, ValueLength recibe el tamaño, en bytes, de los datos que se copiaron en el búfer valor .

[out] Value

Puntero a un búfer que recibe el valor de directiva de canalización especificado.

Valor devuelto

WinUsb_GetPipePolicy devuelve TRUE si la operación se realiza correctamente. De lo contrario, esta rutina devuelve FALSE y el autor de la llamada puede recuperar el error registrado llamando a GetLastError.

GetLastError puede devolver el siguiente código de error.