VideoPortGetAccessRanges 函式 （video.h）
荒廢的。 VideoPortGetAccessRanges 函式會擷取總線相對的組態資訊，如果可能的話，會在呼叫端的登錄中宣告這些硬體資源。
語法
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetAccessRanges(
PVOID HwDeviceExtension,
ULONG NumRequestedResources,
PIO_RESOURCE_DESCRIPTOR RequestedResources,
ULONG NumAccessRanges,
PVIDEO_ACCESS_RANGE AccessRanges,
PVOID VendorId,
PVOID DeviceId,
PULONG Slot
);
參數
HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
NumRequestedResources
指定 RequestedResources 陣列中的項目數目。
RequestedResources
[in， 選擇性]IO_RESOURCE_DESCRIPTOR型別項目的陣列。 每個描述項都會指定迷你埠驅動程式需要、偏好或可作為另一個陣列元素中所指定之替代專案的單一硬體資源。 如需此結構的詳細資訊，請參閱 IoAssignResources的描述。
NumAccessRanges
指定 AccessRanges 陣列中的項目數目。
AccessRanges
[out]指向堆疊上區域或迷你埠驅動程式中靜態結構的指標，VideoPortGetAccessRanges 會傳回填滿適配卡之總線相對裝置記憶體範圍的 VIDEO_ACCESS_RANGE 元素陣列。
VendorId
應該設定為 NULL。
DeviceId
應該設定為 NULL。
Slot
視訊埠驅動程式儲存裝置插槽編號或為 NULL 的記憶體位置指標。
針對隨插即用裝置，如果這是有效的指標，視訊埠驅動程式會將位置號碼儲存在指標所指定的記憶體位置。 如果在呼叫中傳遞 NULL 值，則視訊埠驅動程式不會將值儲存在位置中。
傳回值
VideoPortGetAccessRanges 如果成功填入 AccessRanges 資訊或傳回組態資訊，RequestedResources傳回組態資訊，則會傳回NO_ERROR。
言論
每個視訊迷你埠驅動程式都必須使用 VideoPortGetAccessRanges傳回的存取範圍，或必須先呼叫 VideoPortVerifyAccessRanges，才能嘗試在驅動程式 （和系統） 初始化程式期間存取視訊配接器。
VideoPortGetAccessRanges 只能從迷你埠驅動程式的 HwVidFindAdapter 函式呼叫。
對於大多數迷你埠驅動程式，VideoPortGetAccessRanges 可以擷取、驗證及宣告特定視訊配接器所使用的任何中斷和/或 DMA 信道/埠，而 VideoPortVerifyAccessRanges 只能驗證和宣告迷你埠驅動程式指定的資源。 也就是說，針對傳回的所有組態資訊，VideoPortGetAccessRanges 宣告呼叫者登錄中對應的硬體資源。 除非迷你埠驅動程序嘗試修改任何傳回的值，否則迷你埠驅動程式不需要呼叫 VideoPortVerifyAccessRanges 傳回的總線相對組態資訊。
每個成功呼叫 VideoPortGetAccessRanges 或 VideoPortVerifyAccessRanges，都會覆寫登錄中硬體資源的迷你埠驅動程式先前宣告。
成功呼叫 VideoPortGetAccessRanges之後，迷你埠驅動程式必須先將傳回的總線相對範圍對應至具有 VideoPortGetDeviceBase的邏輯範圍， 然後才能呼叫適當的 VideoPortRead/Write*Xxx 函式來與配接器通訊。
一般而言，PCI 裝置的迷你埠驅動程序應該具有其 HwVidFindAdapter 函式呼叫 VideoPortGetAccessRanges，而不是嘗試操作呼叫 VideoPortGetBusData所傳回的非裝置特定PCI_COMMON_CONFIG資訊。 此迷你埠驅動程式通常可以使用 NULLRequestedResources 指標呼叫 VideoPortGetAccessRanges。 然後，視訊埠驅動程式會使用PCI總線的設定空間來判斷視訊配接器的資源。 迷你埠驅動程式可以使用一組驅動程式提供的 RequestedResources 規格，呼叫 VideoPortGetAccesssRanges，如果原始呼叫無法傳回適配卡的有效組態數據。
請注意，其他類型的 I/O 總線上適配卡的迷你埠驅動程式也可以呼叫 VideoPortGetAccessRanges。 這些驅動程式應該使用 RequestedResources 驅動程式提供之 I/O 資源描述元陣列的指標，呼叫 VideoPortGetAccessSRanges。
如果 HwVidFindAdapter 函式會宣告總線相對存取範圍，而且可能是適配卡的其他硬體資源， 但接著會判斷它不支援適配卡，然後迷你埠驅動程式必須藉由呼叫 VideoPortGetAccessRanges 或 VideoPortVerifyAccessRanges，NumAccessRanges 參數設定為零，以放棄其在登錄中硬體資源的宣告。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 |
| 目標平臺 | 桌面 |
| 標頭 | video.h （include Video.h） |
| 連結庫 | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |