D3DDDIARG_OPENRESOURCE struttura (d3dumddi.h)

Articolo
03/08/2023

La struttura D3DDDIARG_OPENRESOURCE contiene informazioni per l'apertura di una risorsa condivisa.

Sintassi

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

Members

[in] NumAllocations

Numero di elementi nella matrice specificata da pOpenAllocationInfo. NumAllocations rappresenta il numero di allocazioni da aprire.

[in] pOpenAllocationInfo

Matrice di strutture D3DDDI_OPENALLOCATIONINFO che descrivono le allocazioni nella risorsa da aprire.

[in] Matrice di strutture D3DDDI_OPENALLOCATIONINFO che descrivono le allocazioni nella risorsa da aprire.

pOpenAllocationInfo2

Questo membro è riservato e deve essere impostato su zero.

Questo membro è disponibile a partire da Windows 7.

[in] hKMResource

Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel alla risorsa associata alle allocazioni.

Questo handle in modalità kernel rappresenta una risorsa condivisa esistente creata in precedenza tramite una chiamata alla funzione CreateResource del driver di visualizzazione in modalità utente.

[in] pPrivateDriverData

Puntatore ai dati privati passati al driver miniport visualizzato al momento della creazione della risorsa. Questi dati sono per risorsa e non per allocazione come i dati privati nella struttura D3DDDI_OPENALLOCATIONINFO di ogni allocazione.

[in] PrivateDriverDataSize

Dimensioni, in byte, dei dati privati a cui fa riferimento pPrivateDriverData.

[in/out] hResource

Handle alla risorsa associata alle allocazioni.

Il driver di visualizzazione in modalità utente deve salvare questo handle e usarlo per identificare la risorsa in qualsiasi momento in cui il driver viene eseguito nuovamente nel runtime di Microsoft Direct3D. Il driver di visualizzazione in modalità utente deve generare un handle univoco e passarlo di nuovo al runtime Direct3D. Il runtime Direct3D usa questo handle nelle chiamate driver per identificare la risorsa.

[in] Rotation

Valore D3DDDI_ROTATION tipizzato che identifica l'orientamento della risorsa primaria condivisa.

Quando la risorsa primaria viene usata con un dispositivo a schermo intero e viene ruotata, il driver potrebbe essere necessario per creare allocazioni provvisorie per gestire il dispositivo a schermo intero. Il flag di bitfield fullscreen è impostato nel membro Flags per indicare che la risorsa primaria viene usata con un dispositivo a schermo intero.

[in] Flags

Struttura D3DDDI_OPENRESOURCEFLAGS che identifica il tipo di risorsa da aprire.

Commenti

I flag di campo di bit Primario e SharedResource vengono impostati nel membro Flag della struttura D3DDDIARG_CREATERESOURCE in una chiamata alla funzione CreateResource per creare una risorsa primaria condivisa.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	d3dumddi.h (include D3dumddi.h)