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 可以傳回下列錯誤碼。
| 傳回碼 | 描述 |
|---|---|
|
呼叫端在InterfaceHandle參數中傳遞Null。 |
規格需求
| 目標平台 | Universal |
| 標頭 | winusb.h (包含 Winusb.h) |
| 程式庫 | Winusb.lib |
| Dll | Winusb.dll |