WinUsb_GetPipePolicy函式 (winusb.h)

WinUsb_GetPipePolicy函式會擷取與裝置上端點相關聯之特定管道的原則。 這是同步作業。

語法

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

參數

[in] InterfaceHandle

介面的不透明控制碼，其中包含與管道相關聯的端點。

若要查詢與第一個介面中端點相關聯的管道，請使用 WinUsb_Initialize傳回的控制碼。 對於所有其他介面，請使用目標介面的控制碼 ，WinUsb_GetAssociatedInterface擷取。

[in] PipeID

包含 7 位位址和方向位的 8 位值。 此參數會對應至端點描述元中的 bEndpointAddress 欄位。

[in] PolicyType

ULONG變數，指定要擷取的原則參數。 原則參數的目前值會擷取 Value 參數。 如需管道原則行為的相關資訊，請參閱 用於修改管道原則的 WinUSB 函式。

[in, out] ValueLength

Value指向之緩衝區的大小指標，以位元組為單位。 輸出時， ValueLength 會接收復制到 Value 緩衝區的資料大小，以位元組為單位。

[out] Value

接收指定管道原則值的緩衝區指標。

傳回值

如果作業成功，WinUsb_GetPipePolicy傳回TRUE。 否則，這個常式會傳回 FALSE，而呼叫端可以呼叫 GetLastError來擷取記錄的錯誤。

GetLastError 可以傳回下列錯誤碼。

傳回碼	描述
ERROR_INVALID_HANDLE	呼叫端在InterfaceHandle參數中傳遞Null。

規格需求

目標平台	Universal
標頭	winusb.h (包含 Winusb.h)
程式庫	Winusb.lib
Dll	Winusb.dll

另請參閱

WinUSB

WinUSB 函式

用於修改管道原則的 WinUSB 函式

WinUsb_Initialize

WinUsb_ReadPipe

WinUsb_WritePipe