Função UcmInitializeDevice (ucmmanager.h)

Inicializa a extensão da estrutura do gerenciador de conectores USB (UcmCx).

Sintaxe

NTSTATUS UcmInitializeDevice(
  [in] WDFDEVICE           WdfDevice,
  [in] PUCM_MANAGER_CONFIG Config
);

Parâmetros

[in] WdfDevice

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

[in] Config

Um ponteiro para uma estrutura de UCM_MANAGER_CONFIG fornecida pelo chamador que é inicializada chamando UCM_MANAGER_CONFIG_INIT.

Retornar valor

UcmInitializeDevice retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método pode retornar um valor NTSTATUS apropriado.

Comentários

Esse método inicializa o UcmCx e aloca recursos necessários, registra eventos PnP e configura destinos de E/S. O driver do cliente deve chamar esse método na implementação de EVT_WDF_DRIVER_DEVICE_ADD do driver.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Versão mínima do KMDF 1.15
Versão mínima do UMDF 2.15
Cabeçalho ucmmanager.h (inclua Ucmcx.h)
Biblioteca UcmCxstub.lib
IRQL PASSIVE_LEVEL

Confira também

UCM_MANAGER_CONFIG

UCM_MANAGER_CONFIG_INIT