Função UcxEndpointCreate (ucxendpoint.h)

Artigo
02/07/2025

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 de 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.

Valor de retorno

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.

Observações

O driver cliente do controlador de 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
de cliente com suporte mínimo	Windows 10
da 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

Partilhar via