PFND3DKMT_CREATEKEYEDMUTEX2 callback function (d3dkmthk.h)

Creates a keyed mutex object that includes private data.

Syntax

PFND3DKMT_CREATEKEYEDMUTEX2 Pfnd3dkmtCreatekeyedmutex2;

NTSTATUS Pfnd3dkmtCreatekeyedmutex2(
  D3DKMT_CREATEKEYEDMUTEX2 *unnamedParam1
)
{...}

Parameters

unnamedParam1

pData [in, out]

A pointer to a D3DKMT_CREATEKEYEDMUTEX2 structure that describes a keyed mutex object to create.

Return value

Returns one of the following values:

Return code Description
STATUS_SUCCESS The keyed mutex object was successfully created.
STATUS_DEVICE_REMOVED The graphics adapter was stopped or the display device was reset.
STATUS_INVALID_PARAMETER Parameters were validated and determined to be incorrect.
STATUS_NO_MEMORY D3DKMTCreateKeyedMutex2 could not complete because of insufficient memory.

This function might also return other NTSTATUS values.

Remarks

D3DKMTCreateKeyedMutex2 behaves like the D3DKMTCreateKeyedMutex function but lets the caller specify private data to associate with the keyed mutex.

Keyed mutexes created with D3DKMTCreateKeyedMutex2 are still compatible with D3DKMTOpenKeyedMutex, D3DKMTAcquireKeyedMutex, and D3DKMTReleaseKeyedMutex functions.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Universal
Header d3dkmthk.h (include D3dkmthk.h)

See also

D3DKMTAcquireKeyedMutex

D3DKMTCreateKeyedMutex

D3DKMTOpenKeyedMutex

D3DKMTReleaseKeyedMutex

D3DKMT_CREATEKEYEDMUTEX2