Compartilhar via


Método IWDFUsbTargetPipe::RetrievePipePolicy (wudfusb.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método RetrievePipePolicy recupera uma política de pipe winUsb.

Sintaxe

HRESULT RetrievePipePolicy(
  [in]      ULONG PolicyType,
  [in, out] ULONG *ValueLength,
  [out]     PVOID Value
);

Parâmetros

[in] PolicyType

O tipo de política de pipe do WinUsb que o driver UMDF solicita.

[in, out] ValueLength

Um ponteiro para uma variável que, na entrada, contém o tamanho, em bytes, do buffer que RetrievePipePolicy fornece para Value. Na saída, esse parâmetro contém o tamanho que RetrievePipePolicy requer para Value.

[out] Value

Um ponteiro que recebe o buffer que contém a política de pipe do WinUsb.

Retornar valor

RetrievePipePolicy retorna um dos seguintes valores:

Código de retorno Descrição
S_OK

RetrievePipePolicy recuperou com êxito a política de pipe do WinUsb.

E_OUTOFMEMORY

RetrievePipePolicy encontrou uma falha de alocação.

Um código de erro definido em Winerror.h
Esse valor corresponde ao código de erro retornado pela API do WinUsb.

Comentários

A política de pipe controla o comportamento do pipe USB (por exemplo, tempos limite, manipulação de pacotes curtos e assim por diante).

Para obter mais informações sobre tipos de política válidos que um driver UMDF pode passar para o parâmetro PolicyType e os valores que a estrutura retorna, consulte a função WinUsb_GetPipePolicy .

Para obter informações sobre o comportamento das políticas de pipe, consulte Funções do WinUSB para modificação da política de pipe.

O método RetrievePipePolicy gera uma solicitação UMDF e envia a solicitação de forma síncrona para o destino de E/S.

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1.5
Cabeçalho wudfusb.h (include Wudfusb.h)
DLL WUDFx.dll

Confira também

IWDFUsbTargetPipe

IWDFUsbTargetPipe::SetPipePolicy

WinUsb_GetPipePolicy