Compartilhar via

Função UcxEndpointCreate (ucxendpoint.h)

  • Artigo

Cria um ponto de extremidade no objeto de dispositivo USB especificado.

Sintaxe

NTSTATUS UcxEndpointCreate(
  [in]           UCXUSBDEVICE           UsbDevice,
  [out]          PUCXENDPOINT_INIT      *EndpointInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXENDPOINT            *Endpoint
);

Parâmetros

[in] UsbDevice

Um identificador para o objeto de dispositivo USB que contém o ponto de extremidade. O driver cliente recuperou o identificador em uma chamada anterior para UcxUsbDeviceCreate.

[out] EndpointInit

Um ponteiro para uma estrutura UCXENDPOINT_INIT que descreve várias operações de configuração para criar o objeto de ponto de extremidade. O driver especifica ponteiros de função para suas funções de retorno de chamada nessa estrutura. Essa estrutura é gerenciada pelo UCX.

[in, optional] Attributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que especifica atributos para o objeto de ponto de extremidade.

[out] Endpoint

Um ponteiro para uma variável que recebe um identificador para o novo objeto de ponto de extremidade.

Retornar valor

O método retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um código de erro NTSTATUS apropriado.

Comentários

O driver do cliente para o controlador host deve chamar esse método após a chamada WdfDeviceCreate . O pai do novo objeto de ponto de extremidade é o objeto de dispositivo USB.

O método inicializa o objeto de ponto de extremidade com informações como o tipo de ponto de extremidade, pipe, transferência e tamanho máximo de transferências.

Para obter um exemplo de código, consulte EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Plataforma de Destino Windows
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho ucxendpoint.h (inclua Ucxclass.h, Ucxendpoint.h)
IRQL PASSIVE_LEVEL