Funzione IoWMIAllocateInstanceIds (wdm.h)

Articolo
02/07/2025

La routine IoWMIAllocateInstanceIds alloca uno o più ID di istanza univoci per il GUID.

Sintassi

NTSTATUS IoWMIAllocateInstanceIds(
  [in]  LPCGUID Guid,
  [in]  ULONG   InstanceCount,
  [out] ULONG   *FirstInstanceId
);

Parametri

[in] Guid

Puntatore al GUID per il quale generare identificatori di istanza.

[in] InstanceCount

Specifica il numero di identificatori di istanza da specificare.

[out] FirstInstanceId

Puntatore all'identificatore della prima istanza che deve essere usato dal driver.

Valore restituito

IoWMIAllocateInstanceIds restituisce un codice di stato dall'elenco seguente:

Codice restituito	Descrizione
STATUS_SUCCESS	Indica che WMI ha fornito correttamente identificatori di istanza univoci per il GUID specificato.
STATUS_UNSUCCESSFUL	Indica che i servizi WMI non sono disponibili.
STATUS_INSUFFICIENT_RESOURCES	Indica che le risorse insufficienti erano disponibili per fornire al chiamante ID istanza.

Osservazioni

Se è stata richiesta una maggiore di un'istanza in InstanceCount e la routine è stata completata correttamente, FirstInstanceId punta alla prima istanza che il chiamante deve usare. Per ogni istanza richiesta oltre uno, il chiamante deve incrementare il valore restituito in *FirstInstanceId. Ad esempio, se il chiamante ha richiesto sei istanze e una è stata restituita come valore di FirstInstanceId, il chiamante deve usare i valori 1-6 come identificatori univoci dell'istanza.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 2000.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Vedere anche

IoWmiSuggestInstanceName

Condividi tramite