Função WdfDeviceAssignMofResourceName (wdfdevice.h)

  • Artigo

[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 UNICODE_STRING que especifica o nome de um recurso MOF.

Retornar valor

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 disponível.
 

O método pode retornar outros valores NTSTATUS.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

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 EvtDriverDeviceAdd ou EvtDevicePrepareHardware . O nome do recurso MOF é o nome de arquivo que o driver especifica 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 de 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 wmi, consulte Supporting WMI in 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
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)