PFND3D10DDI_CHECKCOUNTER funzione di callback (d3d10umddi.h)

La funzione CheckCounter recupera informazioni che descrivono un contatore.

Sintassi

PFND3D10DDI_CHECKCOUNTER Pfnd3d10ddiCheckcounter;

void Pfnd3d10ddiCheckcounter(
            D3D10DDI_HDEVICE unnamedParam1,
            D3D10DDI_QUERY unnamedParam2,
            D3D10DDI_COUNTER_TYPE *unnamedParam3,
            UINT *unnamedParam4,
            LPSTR unnamedParam5,
  [in, out] UINT *pNameLength,
            LPSTR unnamedParam7,
  [in, out] UINT *pUnitsLength,
            LPSTR unnamedParam9,
  [in, out] UINT *pDescriptionLength
)
{...}

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

Query [in]

Valore D3D10DDI_QUERY tipizzato che identifica l'identificatore del contatore recuperato dalle informazioni.

unnamedParam3

pCounterType [out]

Puntatore a una variabile che riceve uno dei valori seguenti dall'enumerazione D3D10DDI_COUNTER_TYPE che identifica il tipo di dati restituito dal contatore.

unnamedParam4

pDescription [out]

Puntatore che il driver restituisce una stringa con terminazione NULL in che contiene la descrizione delle misure dell'identificatore del contatore.

unnamedParam5

pActiveCounters [out]

Puntatore a una variabile che riceve il numero di contatori attivi contemporaneamente allocati per la creazione dell'identificatore di contatore identificato da Query .

[in, out] pNameLength

Puntatore a una variabile che riceve le dimensioni, in byte, della stringa con terminazione NULL specificata dal parametro pName .

unnamedParam7

pName [out]

Puntatore che il driver restituisce una stringa con terminazione NULL in che contiene il nome dell'identificatore del contatore.

[in, out] pUnitsLength

Puntatore a una variabile che riceve le dimensioni, in byte, della stringa con terminazione NULL specificata dal parametro pUnits .

unnamedParam9

pUnits [out]

Puntatore che il driver restituisce una stringa con terminazione NULL in che contiene il nome delle unità misurate dall'identificatore del contatore.

[in, out] pDescriptionLength

Puntatore a una variabile che riceve le dimensioni, in byte, della stringa con terminazione NULL specificata dal parametro pDescription .

Valore restituito

nessuno

Osservazioni

Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore.

La funzione CheckCounter del driver può chiamare la funzione di callback pfnSetErrorCb per impostare il codice di errore ERR_UNSUPPORTED se il parametro Query di CheckCounterspecifica un contatore noto che il dispositivo non supporta.

Il driver deve convalidare un identificatore del contatore dipendente dal dispositivo per assicurarsi che l'identificatore sia compreso nell'intervallo. Il driver deve inoltre assicurarsi che esista spazio sufficiente per copiare ogni stringa del contatore in ogni buffer fornito dal runtime di Microsoft Direct3D. Il driver può chiamare la funzione di callback pfnSetErrorCb per impostare il codice di errore E_INVALIDARG se non è disponibile spazio sufficiente per uno dei buffer forniti.

La funzione CheckCounter del driver non può chiamare la funzione di callback pfnSetErrorCb per impostare il codice di errore D3DDDIERR_DEVICEREMOVED perché CheckCounter è un tipo di funzione di controllo delle funzionalità. Il driver deve assicurarsi che abbia informazioni sufficienti dopo la creazione del dispositivo per rispondere a una chiamata a CheckCounter, anche in presenza di D3DDDIERR_DEVICEREMOVED.

Requisiti

Vedi anche

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb