Função WdfDeviceAssignMofResourceName (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

O método WdfDeviceAssignMofResourceName registra um nome de recurso MOF para um dispositivo especificado.

Sintaxe

NTSTATUS WdfDeviceAssignMofResourceName(
  [in] WDFDEVICE        Device,
  [in] PCUNICODE_STRING MofResourceName
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] MofResourceName

Um ponteiro para uma estrutura de UNICODE_STRING que especifica o nome de um recurso MOF.

Valor de retorno

Se a operação for bem-sucedida, WdfDeviceAssignMofResourceName retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:

Código de retorno	Descrição
STATUS_INVALID_DEVICE_REQUEST	O driver já chamou WdfDeviceAssignMofResourceName.
STATUS_INSUFFICIENT_RESOURCES	Memória insuficiente está disponível.

O método pode retornar outros valores NTSTATUS .

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Um driver que fornece um arquivo MOF para dar suporte ao WMI deve chamar WdfDeviceAssignMofResourceName, normalmente de dentro de sua função de retorno de chamada EvtDriverDeviceAd d ou EvtDevicePrepareHardware função de retorno de chamada. O nome do recurso MOF é o nome do arquivo especificado pelo driver em uma instrução MofResource em seu arquivo RC (script de recurso). Para obter mais informações sobre como especificar um nome de recurso MOF, consulte Compilando um arquivo MOF do driver.

Um driver que enumera os dispositivos em um barramento pode chamar WdfDeviceAssignMofResourceName para o dispositivo pai e a estrutura usará o nome do recurso MOF pai para dispositivos filho.

Para obter mais informações sobre o WMI, consulte Suporte ao WMI no Framework-Based Drivers.

Exemplos

O exemplo de código a seguir declara uma cadeia de caracteres Unicode que representa um nome de recurso MOF e, em seguida, registra o nome.

NTSTATUS  status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);

status = WdfDeviceAssignMofResourceName(
                                        Device,
                                        &mofRsrcName
                                        );
if (!NT_SUCCESS(status)) {
    return status;
}

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Compartilhar via