Compartilhar via


Função D3DKMTUnlock (d3dkmthk.h)

A função D3DKMTUnlock desbloqueia uma lista de alocações.

Sintaxe

NTSTATUS D3DKMTUnlock(
  [in] const D3DKMT_UNLOCK *unnamedParam1
);

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura D3DKMT_UNLOCK que descreve uma lista de alocações a serem desbloqueadas.

Retornar valor

D3DKMTUnlock retorna um dos seguintes valores;

Código de retorno Descrição
STATUS_SUCCESS As alocações foram desbloqueadas com êxito.
STATUS_INVALID_PARAMETER Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores NTSTATUS .

Comentários

Todas as alocações desbloqueadas pela função D3DKMTUnlock devem pertencer ao mesmo dispositivo.

Exemplos

Os exemplos de código a seguir demonstram como um OpenGL ICD pode usar D3DKMTUnlock para desbloquear três alocações.

HRESULT UnlockThree(D3DKMT_HANDLE hDevice, 
                    D3DKMT_HANDLE hAllocation1, 
                    D3DKMT_HANDLE hAllocation2, 
                    D3DKMT_HANDLE hAllocation3) 
{
    D3DKMT_HANDLE AllocationArray[3];
    D3DKMT_UNLOCK UnlockData;

    AllocationArray[0] = hAllocation1;
    AllocationArray[1] = hAllocation2;
    AllocationArray[2] = hAllocation3;

    UnlockData.hDevice = hDevice;
    UnlockData.NumAllocations = 3;
    UnlockData.phAllocations = AllocationArray;

    if (NT_SUCCESS((*pfnKTUnlock)(&UnlockData))) {
        return S_OK;
    }
    return E_FAIL;
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Universal
Cabeçalho d3dkmthk.h (inclua D3dkmthk.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

D3DKMT_UNLOCK