Função UcmTcpciDeviceInitialize (ucmtcpcidevice.h)

Artigo
02/07/2025

Inicializa a extensão da estrutura da Interface do Controlador de Porta Type-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.

Valor de retorno

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

Observações

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 da estrutura e aloca os recursos necessários, registra-se para eventos PnP e configura destinos de E/S.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	ucmtcpcidevice.h
biblioteca	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Consulte também

WdfDeviceCreate

Compartilhar via