Compartilhar via

Função UcmTcpciDeviceInitialize (ucmtcpcidevice.h)

  • Artigo

Inicializa a extensão da estrutura da Interface do Controlador de Porta Tipo C usb (UcmTcpciCx).

Sintaxe

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

Parâmetros

WdfDevice

Um identificador para um objeto de dispositivo de estrutura que o driver cliente recebeu na chamada anterior para WdfDeviceCreate.

Config

Um ponteiro para uma estrutura de UCMTCPCI_DEVICE_CONFIG fornecida pelo chamador que é inicializada chamando UCMTCPCI_DEVICE_CONFIG_INIT. Esse valor não pode ser NULL.

Retornar valor

(NTSTATUS) 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.

Código de retorno Descrição
STATUS_INFO_LENGTH_MISMATCH
 Tamanho inválido para a estrutura apontada por Config. Deve ter o tamanho de UCMTCPCI_DEVICE_CONFIG.
STATUS_INVALID_DEVICE_STATE
 O estado Plug and Play do objeto do dispositivo da estrutura não é inicializado. Chame UcmTcpciDeviceInitialize dentro da implementação do driver de EVT_WDF_DRIVER_DEVICE_ADD.

Comentários

O driver cliente deve chamar UcmTcpciDeviceInitialize dentro da implementação do driver de EVT_WDF_DRIVER_DEVICE_ADD. Esse método configura o objeto de dispositivo de estrutura e aloca recursos necessários, registra eventos PnP e configura destinos de E/S.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho ucmtcpcidevice.h
Biblioteca Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

Confira também

WdfDeviceCreate