Compartilhar via

Função UcxUsbDeviceCreate (ucxusbdevice.h)

  • Artigo

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.

Retornar valor

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

Comentários

O driver do cliente para o 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
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 ucxusbdevice.h (inclua Ucxclass.h)
IRQL PASSIVE_LEVEL

Confira também

EVT_UCX_CONTROLLER_USBDEVICE_ADD