Função UcxUsbDeviceCreate (ucxusbdevice.h)

Artigo
02/07/2025

Cria um objeto de dispositivo USB no controlador especificado.

Sintaxe

NTSTATUS UcxUsbDeviceCreate(
  [in]           UCXCONTROLLER          Controller,
  [out]          PUCXUSBDEVICE_INIT     *UsbDeviceInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXUSBDEVICE           *UsbDevice
);

Parâmetros

[in] Controller

Um identificador para o objeto do controlador. O driver cliente recuperou o identificador em uma chamada anterior para ucxControllerCreate.

[out] UsbDeviceInit

Um ponteiro para uma estrutura UCXUSBDEVICE_INIT que descreve várias operações de configuração para criar o objeto de dispositivo USB. 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 dispositivo USB.

[out] UsbDevice

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

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 dispositivo USB é o dispositivo de hub pai especificado pelo UCX.

Para obter um exemplo de código, consulte EVT_UCX_CONTROLLER_USBDEVICE_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	ucxusbdevice.h (inclua Ucxclass.h)
IRQL	PASSIVE_LEVEL

Consulte também

EVT_UCX_CONTROLLER_USBDEVICE_ADD

Compartilhar via