Funzione WdfDeviceAssignMofResourceName (wdfdevice.h)

Articolo
02/07/2025

[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:

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	Il driver ha già chiamato WdfDeviceAssignMofResourceName.
STATUS_INSUFFICIENT_RESOURCES	Memoria insufficiente disponibile.

Il metodo potrebbe restituire altri valori NTSTATUS .

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni

Un driver che fornisce un file MOF per supportare WMI deve chiamare WdfDeviceAssignMofResourceName, in genere dall'interno del relativo EvtDriverDeviceAdd o EvtDevicePrepareHardware funzione di callback. Il nome della risorsa MOF è il nome file specificato dal driver in un 'istruzione MofResource nel file dello script di risorsa (RC). Per altre informazioni sulla specifica di un nome di risorsa MOF, vedere Compilazione di un file MOF del 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 dell'elemento padre per i dispositivi figlio.

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

Esempi

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;
}

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Condividi tramite