Funzione WdfDeviceAssignMofResourceName (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfDeviceAssignMofResourceName registra un nome di risorsa MOF per un dispositivo specificato.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] MofResourceName

Puntatore a una struttura UNICODE_STRING che specifica il nome di una risorsa MOF.

Valore restituito

Se l'operazione ha esito positivo, WdfDeviceAssignMofResourceName restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Il metodo potrebbe restituire altri valori NTSTATUS.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Un driver che fornisce un file MOF per supportare WMI deve chiamare WdfDeviceAssignMofResourceName, in genere dall'interno della relativa funzione di callback EvtDriverDeviceAdd o EvtDevicePrepareHardware. Il nome della risorsa MOF è il nome del file specificato dal driver in un'istruzione MofResource nel file dello script di risorse (RC). Per altre informazioni sulla specifica di un nome di risorsa MOF, vedere Compilazione di un file MOF di un driver.

Un driver che enumera i dispositivi in un bus può chiamare WdfDeviceAssignMofResourceName per il dispositivo padre e il framework userà il nome della risorsa MOF padre per i dispositivi figlio.

Per altre informazioni su WMI, vedere Supporto di WMI nei driver di Framework-Based.

Esempio

Nell'esempio di codice seguente viene dichiarata una stringa Unicode che rappresenta un nome di risorsa MOF e quindi registra il nome.

NTSTATUS  status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);

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

Requisiti